In This Topic ▼

L_DicomSendAssociateRequest

#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.

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.

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

Download our FREE evaluation

Help Version 21.0.2021.7.2

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Quick Reference

Function References

Appendix