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

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C API Help
Click or drag to resize