In This Topic ▼

RECEIVEASSOCIATEREJECTCALLBACK

Summary

Notifies a connection that an Associate Reject message was received. This function is available in the PACS Imaging.

Syntax

#include "ltdic.h"

L_VOID pEXT_CALLBACK Your Function(hNet, nResult, nSource, nReason, UserData)

Parameters

HDICOMNET hNet

A DICOM Network handle.

L_UCHAR nResult

Type of rejection. Possible values are:

Value	Meaning
PDU_REJECT_RESULT_PERMANENT	[1] Rejected permanently.
PDU_REJECT_RESULT_TRANSIENT	[2] Rejected transiently.

L_UCHAR nSource

The source of the rejection. Possible values are:

Value	Meaning
PDU_REJECT_SOURCE_USER	[1] DICOM Upper Layer Service User.
PDU_REJECT_SOURCE_PROVIDER1	[2] DICOM Upper Layer Service Provider (ASCE related function)
PDU_REJECT_SOURCE_PROVIDER2	[3] DICOM Upper Layer Service Provider (Presentation related function)

L_UCHAR nReason

Reason for the rejection. This depends on the value of nSource. Possible values are:

Value	Meaning
If nSource is PDU_REJECT_SOURCE_USER:
PDU_REJECT_REASON_UNKNOWN	[1] Unknown
PDU_REJECT_REASON_APPLICATION	[2] Application context name not supported.
PDU_REJECT_REASON_CALLING	[3] Calling AE Title not recognized.
PDU_REJECT_REASON_CALLED	[7] Called AE Title not recognized.
If nSource is PDU_REJECT_SOURCE_PROVIDER1:
PDU_REJECT_REASON_UNKNOWN	[1] Unknown.
PDU_REJECT_REASON_VERSION	[2] Protocol version not supported.
If nSource is PDU_REJECT_SOURCE_PROVIDER2:
PDU_REJECT_REASON_CONGESTION	[1] Temporary congestion.
PDU_REJECT_REASON_LIMIT	[2] Local client limit exceeded.

L_VOID * UserData

Void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function.

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

None.

Comments

A call to this function is generated on an SCU when an SCP calls L_DicomSendAssociateReject. For more information on DICOM Associate connections, refer to Creating a DICOM Associate Connection.

To use this callback function, RECEIVEASSOCIATEREJECTCALLBACK must be set using L_DicomSetCallback.