L_DicomSetMutualAuthKeyISCL

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomSetMutualAuthKeyISCL(hNet, nIndex, nKey)

HDICOMNET hNet;

/* handle to an existing DICOM Network */

L_UINT32 nIndex;

/* index */

L_UINT64 nKey;

/* authentication key */

Sets a mutual authentication key at the specified index in the array.

Parameter

Description

hNet

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

nIndex

Index into the array of authentication keys. This index is 1-based. Possible values for this index are between 1 and 8, inclusive.

nKey

A 64-bit integer, in little endian byte order, that represents an authentication key used during the mutual authentication process.

Returns

DICOM_SUCCESS

Success. The specified key was set in the specified position in the keys array.

DICOM_ERROR_PARAMETER

A parameter error occurred. nIndex was 0 or bigger than 8. Refer to Return Codes.

Comments

One of eight mutual authentication keys can be used for authenticating a peer. For more information, refer to Adding Security to a DICOM Connection and the ISCL standard.

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_DicomSetMutualAuthAlgISCL, L_DicomSetIndexForMutualAuthISCL, 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 DicomSetMutualAuthKeyISCLExample(L_VOID)
{
   L_INT nRet;
   HDICOMNET hDicomNet;
   hDicomNet = L_DicomCreateNet (TEXT(""), DICOM_SECURE_ISCL);
   nRet = L_DicomSetMutualAuthKeyISCL(hDicomNet, 1, 0x0123456789ABCDEF);
   // 64-bit value, in hexadecimal // notation
   return nRet;
}