Is this page helpful?
Sets the authentication data used during the mutual authentication process. This function is available in PACS Imaging toolkits.
#include "ltdic.h"
L_LTDIC_API L_UINT32 L_DicomSetAuthDataISCL(hNet, pBuffer, nLength)
Handle to an existing DICOM Network. This is the handle returned from the L_DicomCreateNet function.
Pointer to an array containing the authentication data.
Length of the authentication data, in bytes.
Value | Meaning |
---|---|
DICOM_SUCCESS | The function was successful. |
DICOM_ERROR_PARAMETER | A parameter error occurred. The authentication data could not be set. (pBuffer is NULL, or nLength is not in the range 1 to 128.). Refer to Return Codes. |
Every ISCL-compliant entity must have between 1 and 128 bytes of authentication data. These authentication data are exchanged between client and server during the mutual authentication process. This function sets an array of 1 to 128 bytes that contains authentication data.
The authentication data is data exchanged in plain text. After the mutual authentication process, the communication entities can verify the authentication data of the other entity (client or server) and, if the authentication data is wrong, can close the connection.
Win32, x64.
L_INT DicomSetAuthDataISCLExample(L_VOID)
{
HDICOMNET hNet1, hNet2;
L_INT nRet;
nRet = L_DicomStartUp();
if (nRet != DICOM_SUCCESS)
return nRet;
hNet1 = L_DicomCreateNet (TEXT(""), DICOM_SECURE_ISCL);
hNet2 = L_DicomCreateNet(TEXT(""), DICOM_SECURE_ISCL);
nRet = L_DicomSetAuthDataISCL(hNet1, TEXT("Server LEAD ISCL"), 13);
if (nRet != DICOM_SUCCESS)
{
L_DicomFreeNet(hNet1);
L_DicomFreeNet(hNet2);
L_DicomShutDown();
return nRet;
}
char data[5] = {0x21, 0x14, 0x00, 0x45, 0x0F};
nRet = L_DicomSetAuthDataISCL(hNet2, data, 5);
// authentication data can be binary data
// delete hNet1, hNet2 and shutdown the DICOM network
L_DicomFreeNet(hNet1);
L_DicomFreeNet(hNet2);
L_DicomShutDown();
return nRet;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document