#include "ltdic.h"
L_LTDIC_API L_INT L_DicomSendAssociateRequest(hNet, hPDU)
Sends an Associate Request message to a connection. This function is available in the PACS Imaging Toolkit.
A DICOM Network handle. This is the handle created by calling L_DicomCreateNet.
A DICOM Association handle. This is the handle created by calling L_DicomCreateAssociate.
Value | Meaning |
---|---|
DICOM_SUCCESS | The function was successful. |
>0 | An error occurred. Refer to Return Codes. |
Calling L_DicomSendAssociateRequest on an SCU generates a call to RECEIVEASSOCIATEREQUESTCALLBACK on the SCP. Within the callback function the SCP may accept or reject the Association request by calling L_DicomSendAssociateAccept or L_DicomSendAssociateReject.
A DICOM Association must be established between an SCU and an SCP before any DICOM messages or data can be transmitted between them. For more information on creating a DICOM Association, refer to Creating a DICOM Associate Connection.
When the DICOM Association is no longer needed, it should be ended. For more information, refer to Closing a DICOM Association.
Required DLLs and Libraries
Win32, x64, Linux.
This example sends an Associate Request message to a connection
L_INT DicomSendAssociateRequestExample(HDICOMNET hNet)
{
HDICOMPDU hPDU=NULL;
L_INT nRet;
/* create the Associate Class as Request */
hPDU = L_DicomCreateAssociate(TRUE);
/* use default for association */
L_DicomDefaultAssociate(hPDU);
/* this shows a client sending to its server */
nRet = L_DicomSendAssociateRequest(hNet, hPDU);
if (nRet != DICOM_SUCCESS)
return nRet;
/* now we can free the class */
L_DicomFreeAssociate(hPDU);
return DICOM_SUCCESS;
}
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