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