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