RECEIVEASSOCIATEREJECTCALLBACK

#include "ltdic.h"

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

HDICOMNET hNet;	/* a DICOM Network handle */
L_UCHAR nResult;	/* type of rejection */
L_UCHAR nSource;	/* source of rejection */
L_UCHAR nReason;	/* reason for rejection */
L_VOID * UserData;	/* pointer to additional data */

Notifies a connection that an Associate Reject message was received. This function is available in the Medical Suite Toolkit.

Parameter	Description
hNet	A DICOM Network handle.
nResult	Type of rejection. Possible values are:
	Value	Meaning
	PDU_REJECT_RESULT_PERMANENT	[1] Rejected permanently.
	PDU_REJECT_RESULT_TRANSIENT	[2] Rejected transiently.
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)
nReason	Reason for the rejection. This depends on the value of nSource. If nSource is PDU_REJECT_SOURCE_USER, the possible values are:
	Value	Meaning
	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, the possible values are:
	Value	Meaning
	PDU_REJECT_REASON_UNKNOWN	[1] Unknown.
	PDU_REJECT_REASON_VERSION	[2] Protocol version not supported.
	If nSource is PDU_REJECT_SOURCE_PROVIDER2, the possible vlaues are:
	Value	Meaning
	PDU_REJECT_REASON_CONGESTION	[1] Temporary congestion.
	PDU_REJECT_REASON_LIMIT	[2] Local client limit exceeded.
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.

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

Functions:	L_DicomSendAssociateReject, L_DicomSendAssociateAccept, L_DicomSendAssociateRequest, L_DicomSetCallback, RECEIVEASSOCIATEACCEPTCALLBACK, RECEIVEASSOCIATEREQUESTCALLBACK
Topics:	Creating a DICOM Associate Connection
	Receiving Messages
	Diagram of a Basic SCU-SCP Set-up
	Creating an SCU
	Creating an SCP