L_DicomCreateAssociate

#include "ltdic.h"

L_LTDIC_API HDICOMPDU L_DicomCreateAssociate(bRequest)

L_BOOL bRequest;

flag that indicates the type of association to create

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

Parameter	Description
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:

L_DicomSetApplication

L_DicomSetPresentation

L_DicomSetImplementClass

L_DicomSetAsyncOperations

L_DicomSetRoleSelect

L_DicomSetImplementVersion

L_DicomSetUserInfo

L_DicomSetExtended

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

Help Version 19.0.2017.10.27

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Functions:	L_DicomFreeAssociate, L_DicomDefaultAssociate, L_DicomResetAssociate, L_DicomSetRequest,L_DicomSetVersion, L_DicomSetCalled, L_DicomSetCalling, L_DicomSetApplication, L_DicomSetPresentation, L_DicomSetResult, L_DicomSetAbstract, L_DicomSetTransfer, L_DicomSetMaxLength, L_DicomSetImplementClass, L_DicomSetAsyncOperations, L_DicomSetRoleSelect, L_DicomSetImplementVersion, L_DicomSetUserInfo, L_DicomSetExtended
Topics:	Working with DICOM Associate Connections
	Creating a DICOM Associate Connection
	Closing a DICOM Associate Connection