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.

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 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

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