L_DicomGetEncryptKeyLengthTLS

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomGetEncryptKeyLengthTLS(hNet, cipher)

HDICOMNET hNet;

handle to an existing DICOM Network

L_CIPHERSUITE cipher;

ciphersuite

Returns the effective length (in bits) of the encryption key associated with the specified ciphersuite (56 for DES etc). This function is available in  Medical Suite toolkits.

Parameter

Description

hNet

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

cipher

Value that indicates the ciphersuite for which to get the length of the encryption key.

Returns

Returns the effective length of the encryption key associated with the specified ciphersuite.

Comments

There are differences between the size of the key and the effective length. The security of a key is given by the effective length, not by the size (a DES key has 8 bytes, just like a DES40 key, but the first has 56 bits effective, and the second only 40.)

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_DicomGetMutualAuthKeyLengthTLS

Topics:

DICOM Net: TLS Protocol

 

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_LTDICTEX_API L_INT DicomGetEncryptKeyLengthTLSExample(L_VOID) 
{ 
   HDICOMNET hDicomNet = NULL; 
   L_INT nRet; 
   hDicomNet = L_DicomCreateNetExt(MAKE_IMAGE_PATH(TEXT("")), DICOM_SECURE_TLS, NULL); 
   nRet = L_DicomGetEncryptKeyLengthTLS(hDicomNet, TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA); 
   L_TCHAR strMsg[64]; 
   wsprintf(strMsg, TEXT("Effective key length for TLS_DHE_RSA_WITH_DES_EDE_CBC_SHA is %d"), nRet); 
   MessageBox(NULL, strMsg, TEXT(""), MB_OK); 
   return DICOM_SUCCESS; 
} 

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C API Help
Click or drag to resize