L_DicomSetIndexForMutualAuthISCL

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomSetIndexForMutualAuthISCL(hNet, nIndex)

HDICOMNET hNet;	/* handle to an existing DICOM Network */
L_UINT32 nIndex;	/* index */

Sets the index of the mutual authentication key to be used during the mutual authentication process. This function is available in the PACS Imaging toolkits.

Parameter	Description
hNet	Handle to an existing DICOM Network. This is the handle returned from the L_DicomCreateNet function.
nIndex	Index of the key to be used for mutual authentication. Possible values for this index are between 1 and 8, inclusive.

Returns

DICOM_SUCCESS	Success. The key in the specified location in the array was set as the key to use for mutual authentication.
DICOM_ERROR_PARAMETER	A parameter error occurred. nIndex was 0 or bigger than 8. Refer to Return Codes.

Comments

This function sets the actual key used for mutual authentication operations, based on an index from 1 to 8

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_DicomSetMutualAuthKeyISCL, L_DicomSetDefaultSigningISCL, L_DicomSetDefaultEncryptionISCL, L_DicomSetAuthDataISCL, L_DicomSetMaxCommBlockLengthISCL, L_DicomSetMaxMessageLengthISCL, L_DicomSetMutualAuthAlgISCL, L_DicomSetEncryptKeyISCL, L_DicomSetIndexForEncryptISCL
Topics:	DICOM Net: Working with authentication key
	Adding Security to a DICOM Connection
	General Integrated Secure Communication Layer (ISCL) Information

Example

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

   hDicomNet = L_DicomCreateNet (TEXT(""), DICOM_SECURE_ISCL);
   nRet = L_DicomSetMutualAuthKeyISCL (hDicomNet, 1, 0x0123456789ABCDEF);
   if (nRet != DICOM_SUCCESS)
      return nRet;

   // 64-bit value, in hexadecimal notation
   return L_DicomSetIndexForMutualAuthISCL(hDicomNet, 1);
}