L_DicomSetMutualAuthAlgISCL

Show in webframe

#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.

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