L_DicomGetAssociate

#include "ltdic.h"

L_LTDIC_API HDICOMPDU L_DicomGetAssociate(hNet)

HDICOMNET hNet;

/* a DICOM Network handle */

Returns the DICOM Associate handle for the specified DICOM Network handle. This function is available in the PACS Imaging Toolkit.

Parameter

Description

hNet

A DICOM Network handle.

Returns

The DICOM Associate handle associated with the specified DICOM Network handle.

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

When the DICOM Association is no longer needed, it should be ended. For more information, refer to Closing a DICOM Associate Connection.

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

See Also

Topics:

Working with DICOM Associate Connections

Example

This example displays the called Application Entity Title of the associated connection 

L_INT DicomGetAssociateExample(HDICOMNET hNet)
{
   HDICOMPDU hAssociate;

   L_TCHAR szCalled[PDU_MAX_TITLE_SIZE+1];
   hAssociate = L_DicomGetAssociate(hNet);

   if(hAssociate)
   {
      L_DicomGetCalled(hAssociate, szCalled, PDU_MAX_TITLE_SIZE+1);
      MessageBox(NULL, szCalled, TEXT("Notice"), MB_OK);
      return DICOM_SUCCESS;
   }
   return DICOM_ERROR_PARAMETER;
}