L_DicomSetDefaultEncryptionISCL

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomSetDefaultEncryptionISCL(hNet, EncryptionMode)

HDICOMNET hNet;	/* handle to an existing DICOM Network */
L_UINT32 EncryptionMode;	/* encryption mode */

Sets the encryption mode used by the ISCL operations.

Parameter	Description
hNet	Handle to an existing DICOM Network. This is the handle returned from the L_DicomCreateNet function.
EncryptionMode	Flag that specifies the encryption mode. Possible values are:
	Value	Meaning
	DICOM_ISCL_ENCRYPT_NONE	[0x00000000]The data is transmitted without encryption.
	DICOM_ISCL_ENCRYPT_DESCBC	[0x00001212] The data is transmitted encrypted using the DES algorithm in cipher block chaining mode.

Returns

DICOM_SUCCESS	The function was successful.
DICOM_ERROR_PARAMETER	A parameter error occurred. The encryption mode will be set to DICOM_ISCL_ENCRYPT_NONE. Refer to Return Codes.

Comments

If an incorrect value is passed for the EncryptionMode parameter, the encryption mode is set to DICOM_ISCL_ENCRYPT_NONE.

This function may be called after an LDicomNet object is created, regardless of whether a connection has been established.

Required DLLs and Libraries

LTDIC

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_DicomCreateNet, L_DicomStartUp, L_DicomSetDefaultSigningISCL, L_DicomSetAuthDataISCL, L_DicomSetMaxCommBlockLengthISCL, L_DicomSetMaxMessageLengthISCL, L_DicomSetMutualAuthAlgISCL, L_DicomSetMutualAuthKeyISCL, L_DicomSetIndexForMutualAuthISCL, L_DicomSetEncryptKeyISCL, L_DicomSetIndexForEncryptISCL
Topics:	DICOM Net: Encryption mode
	Adding Security to a DICOM Connection
	General Integrated Secure Communication Layer (ISCL) Information

Example

L_INT DicomSetDefaultEncryptionISCLExample(L_VOID)
{
   int nRet;
   HDICOMNET hNet = NULL;
   
   nRet = L_DicomStartUp();
   if (nRet != DICOM_SUCCESS)
      return nRet;
   hNet = L_DicomCreateNet (TEXT(""), DICOM_SECURE_NONE);
   nRet = L_DicomSetDefaultEncryptionISCL(hNet, DICOM_ISCL_ENCRYPT_DESCBC);
   L_DicomShutDown();
   return nRet;
}