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