L_DicomSetMutualAuthAlgISCL

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomSetMutualAuthAlgISCL(hNet, mutualAuthMode)

HDICOMNET hNet;

/* handle to an existing DICOM network */

L_UINT32 mutualAuthMode;

/* mutual authentication mode */

Sets the mutual authentication mode. Currently only L_ISCL_MUTUAL_AUTH_3P4W, the three pass four way mutual authentication, is described in the standard. This function is available in the Medical Suite toolkits.

Parameter

Description

hNet

Handle to an existing DICOM Network. This is the handle returned from the L_DicomCreateNet function.

mutualAuthMode

Flag that indicates the mutual authentication mode to use. Currently, only DICOM_ISCL_MUTUAL_AUTH_3P4W is supported.

Returns

DICOM_SUCCESS

Success. The mutual authentication mode was successfully set.

DICOM_ERROR_PARAMETER

A parameter error occurred. The mutual authentication mode will be DICOM_ISCL_MUTUAL_AUTH_3P4W. Refer to Return Codes.

Comments

The implicit value for the mutual authentication protocol is set at creation to DICOM_ISCL_MUTUAL_AUTH_3P4W.

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_DicomSetDefaultSigningISCL, L_DicomSetDefaultEncryptionISCL, L_DicomSetAuthDataISCL, L_DicomSetMaxCommBlockLengthISCL, L_DicomSetMaxMessageLengthISCL, L_DicomSetMutualAuthKeyISCL, L_DicomSetIndexForMutualAuthISCL, L_DicomSetEncryptKeyISCL, L_DicomSetIndexForEncryptISCL

Topics:

DICOM Net: Authentication Data, mode and process

 

Adding Security to a DICOM Connection

 

General Integrated Secure Communication Layer (ISCL) Information

Example

L_INT DicomSetMutualAuthAlgISCLExample(L_VOID)
{
   L_INT nRet;
   HDICOMNET hDicomNet;

   hDicomNet = L_DicomCreateNet (TEXT(""), DICOM_SECURE_ISCL);
   nRet = L_DicomSetMutualAuthAlgISCL(hDicomNet, DICOM_ISCL_MUTUAL_AUTH_3P4W);

   // other initializations
   return nRet;
}