L_DicomGetMutualAuthKeyLengthTLS

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomGetMutualAuthKeyLengthTLS(hNet, cipher)

HDICOMNET hNet;

handle to an existing DICOM Network

L_CIPHERSUITE cipher;

ciphersuite

Returns the effective length (in bits) of the mutual authentication key associated with the specified ciphersuite. This function is available in Medical Suitetoolkits.

Parameter

Description

hNet

Handle to an existing DICOM Network. This is the handle returned from the L_DicomCreateNet function.

cipher

Value that represents the current ciphersuite for which to get the length of the mutual authentication key.

Returns

Returns the effective length of the mutual authentication key.

Comments

The usual sizes for a RSA key is 512 and 1024 bits. There is a limitation for import in Europe a RSA key must be at least 768 bits long. There are no known export restrictions. In addition, the length of the mutual authentication key can be found only after a successful call to the L_DicomSetClientCertificateTLS or L_DicomSetServerCertificateTLS function.

Required DLLs and Libraries

LTDIC
LTCRY

LTTLS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64.

See Also

Functions:

L_DicomGetAuthenticationAlgorithmTLS, L_DicomGetIntegrityAlgorithmTLS, L_DicomGetEncryptionAlgorithmTLS, L_DicomGetKeyExchangeAlgorithmTLS, L_DicomGetEncryptKeyLengthTLS

Topics:

DICOM Net: Working with authentication key

 

Adding TLS Security to a DICOM Connection

 

Negotiating a Ciphersuite

 

General Transport Layer Secure (TLS) Information

Example

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
L_INT DicomGetMutualAuthKeyLengthTLSExample(L_VOID) 
{ 
   HDICOMNET hDicomNet = NULL; 
   L_INT nRet; 
   hDicomNet = L_DicomCreateNetExt(MAKE_IMAGE_PATH(TEXT("")), DICOM_SECURE_TLS, NULL); 
   nRet = L_DicomGetMutualAuthKeyLengthTLS(hDicomNet, TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA); 
   L_TCHAR strMsg[128]; 
   wsprintf(strMsg, TEXT("Mutual authentication key length for TLS_DHE_RSA_WITH_DES_EDE_CBC_SHA is %d"), nRet); 
   MessageBox(NULL, strMsg, TEXT(""), MB_OK); 
   return DICOM_SUCCESS; 
} 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C API Help