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