In This Topic ▼

L_DicomCreateAssociate

Summary

Creates a handle to a DICOM Associate of the specified type.

Syntax

#include "ltdic.h"

L_LTDIC_API HDICOMPDU L_DicomCreateAssociate(bRequest)

Parameters

L_BOOL bRequest

Flag that indicates whether to create an Associate Request or an Associate Accept. possible values are:

Value	Meaning
TRUE	Create an Associate Request.
FALSE	Create an Associate Accept.

Returns

A handle to the newly created DICOM Associate.

Comments

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.

The characteristics of the DICOM Associate Connection may be set using L_DicomDefaultAssociate or by calling the following functions:

When the DICOM Association is no longer needed, it should be closed. 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

L_INT DicomCreateAssociateExample(L_VOID) 
{ 
   HDICOMPDU hPDU; 
    
   /*create the Associate Class as Request*/ 
   hPDU = L_DicomCreateAssociate(TRUE); 
 
   /*set the Associate to the default*/ 
   L_DicomDefaultAssociate(hPDU); 
 
   /*Get presentations here*/ 
   if (L_DicomIsRequest(hPDU)) 
      MessageBox(NULL, TEXT("Associate Request? TRUE"), TEXT("Test"), MB_OK); 
   else 
      MessageBox(NULL, TEXT("Associate Request? FALSE"), TEXT("Test"), MB_OK); 
 
   /*reset the Associate class to Accept*/ 
   L_DicomResetAssociate(hPDU, FALSE); 
 
   /*set the Associate to the default*/ 
   L_DicomDefaultAssociate(hPDU); 
 
   if (L_DicomIsRequest(hPDU)) 
      MessageBox(NULL, TEXT("Associate Request? TRUE"), TEXT("Test"), MB_OK); 
   else 
      MessageBox(NULL, TEXT("Associate Request? FALSE"), TEXT("Test"), MB_OK); 
 
   /*free the Associate class*/ 
   L_DicomFreeAssociate(hPDU); 
 
   return DICOM_SUCCESS; 
}