L_DicomIsAssociated

#include "ltdic.h"

L_LTDIC_API L_BOOL L_DicomIsAssociated(hNet)

/* a DICOM Network handle */

Indicates whether the specified connection has been associated. This function is available in the PACS Imaging Toolkit.

Parameter	Description
hNet	A DICOM Network handle. This is the handle created by calling L_DicomCreateNet.

Returns

TRUE	The specified connection has been associated.
FALSE	The specified connection has not been associated.

Comments

A connection has been associated if the SCP of the connection has called L_DicomSendAssociateAccept and the RECEIVEASSOCIATEACCEPTCALLBACK was generated on the SCU of the connection. If this exchange has occurred, this function will return TRUE, otherwise it will return FALSE.

For more information on creating an associated connection, refer to Creating 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

See Also

Functions:	L_DicomSendAssociateAccept, RECEIVEASSOCIATEACCEPTCALLBACK, L_DicomCreateAssociate, L_DicomCreateNet, L_DicomStartUp, L_DicomSendAssociateRequest
Topics:	Working with DICOM Network Connections
	Creating a DICOM Network Connection
	Creating an DICOM Associate Connection

Example

This example displays the association status of a connection.

L_INT DicomIsAssociatedExample(HDICOMNET hNet)
{
   if (L_DicomIsAssociated(hNet) != FALSE)
      MessageBox(NULL, TEXT("associated"), TEXT("Notice"), MB_OK);
   else
      MessageBox(NULL, TEXT("not associate"), TEXT("Notice"), MB_OK);

   return DICOM_SUCCESS;
}