In This Topic ▼

L_DicomSendAssociateRequest

Summary

Sends an Associate Request message to a connection. This function is available in the PACS Imaging Toolkit.

Syntax

#include "ltdic.h"

L_LTDIC_API L_INT L_DicomSendAssociateRequest(hNet, hPDU)

Parameters

HDICOMNET hNet

A DICOM Network handle. This is the handle created by calling L_DicomCreateNet.

HDICOMPDU hPDU

A DICOM Association handle. This is the handle created by calling L_DicomCreateAssociate.

Returns

Value	Meaning
DICOM_SUCCESS	The function was successful.
>0	An error occurred. Refer to Return Codes.

Comments

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

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, Linux.

Example

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