L_DicomGetEncryptionAlgorithmTLS

L_LTDIC_API L_UINT32 L_DicomGetEncryptionAlgorithmTLS (hNet, cipher)

HDICOMNET hNet;	/* handle to an existing DICOM Network */
L_CIPHERSUITE cipher;	/* the ciphersuite */

Returns the encryption mode (DES, 3DES, etc) for the cipher.

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 encryption mode or algorithm.

Returns

A value that indicates the encryption mode or algorithm. Possible values are:

Value	Meaning
L_CRYPT_NONE	[0x00] No encryption. Returned if no secure connection is established.
L_CRYPT_DES	[0x01] DES encryption.
L_CRYPT_3DES	[0x02] 3DES encryption.
L_CRYPT_RC4	[0x03] RC4 encryption.
L_CRYPT_RC2	[0x04] RC2 encryption.
L_CRYPT_IDEA	[0x05] International Data Encryption Algorithm.
L_CRYPT_FORTEZZA	[0x06] Fortezza encryption.

Comments

There are several different cipher suites. Some of these differ only in encryption mode or algorithm.

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_DicomGetKeyExchangeAlgorithmTLS, L_DicomGetEncryptKeyLengthTLS, L_DicomGetMutualAuthKeyLengthTLS
Topics:	DICOM Net: TLS Protocol
	Adding TLS Security to a DICOM Connection
	Negotiating a Ciphersuite
	General Transport Layer Secure (TLS) Information

Example

L_INT DicomGetEncryptionAlgorithmTLSExample(L_VOID)
{
   HDICOMNET hDicomNet = NULL;
   L_INT nRet;

   // create and initialize hDicomNet
   // . . .

   nRet = L_DicomGetEncryptionAlgorithmTLS(hDicomNet, TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA);
   if(nRet == L_CRYPT_3DES)
      MessageBox(NULL, TEXT("Encryption in TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA is L_CRYPT_3DES"), TEXT(""), MB_OK);

   return DICOM_SUCCESS;
}