L_DicomSetDefaultEncryptionISCL

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomSetDefaultEncryptionISCL(nNet, nEncryptionMode)

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

Sets the encryption mode used by the ISCL operations. 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.
nEncryptionMode	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 nEncryptionMode 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

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;
}