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:
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 |
See Also
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; }