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

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

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

Help Version 23.0.2024.7.1
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.