L_DicomSetMutualAuthKeyISCL

Summary

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

Syntax

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomSetMutualAuthKeyISCL(hNet, nIndex, nKey)

Parameters

HDICOMNET hNet

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

L_UINT32 nIndex

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

L_UINT64 nKey

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

Returns

Value Meaning
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

Platforms

Win32, x64.

See Also

Functions

Topics

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; 
} 
Help Version 23.0.2024.7.1
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.