L_DicomGetIndexForMutualAuthISCL

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomGetIndexForMutualAuth(hNet)

/* handle to an existing DICOM Network */

Gets the current index of the mutual authentication key to be used during the mutual authentication process. This function is available in the Medical Suite toolkits.

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

Returns

The index for the key used for mutual authentication. This value must be between 1 and 8, inclusively, where 1 represents the first key in the array.

Comments

This function gets the index of the actual key used for mutual authentication operations. This index can be between 1 and 8, inclusively.

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

See Also

Functions:	L_DicomCreateNet, L_DicomSetIndexForMutualAuthISCL, L_DicomSetMutualAuthKeyISCL, L_DicomSetDefaultSigningISCL, L_DicomSetDefaultEncryptionISCL, L_DicomSetAuthDataISCL, L_DicomSetMaxCommBlockLengthISCL, L_DicomSetMaxMessageLengthISCL, L_DicomSetMutualAuthAlgISCL, 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 DicomGetIndexForMutualAuthISCLExample(L_VOID)
{
   HDICOMNET hDicomNet;
   L_UINT32 nIndex;
   L_INT nRet;

   hDicomNet = L_DicomCreateNet (TEXT(""), DICOM_SECURE_ISCL);
   nRet = L_DicomSetMutualAuthKeyISCL (hDicomNet, 1, 0x0123456789ABCDEF);
   if (nRet != DICOM_SUCCESS)
      return nRet;

   // 64-bit value, in hexadecimal notation
   nRet = L_DicomSetIndexForMutualAuthISCL (hDicomNet, 1);
   if (nRet != DICOM_SUCCESS)
      return nRet;

   // other source code
   nIndex = L_DicomGetIndexForMutualAuthISCL(hDicomNet);

   return DICOM_SUCCESS;
}