LDicomNet::OnReceiveAssociateReject

#include "ltdic.h"

virtual L_VOID LDicomNet::OnReceiveAssociateReject(nResult, nSource, nReason)

L_UCHAR nResult;	/* type of rejection */
L_UCHAR nSource;	/* source of rejection */
L_UCHAR nReason;	/* reason for rejection */

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

Parameter	Description
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.

Returns

None.

Comments

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

To customize this function, you must derive a class from LDicomNet and override this function.

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:	LDicomNet::SendAssociateReject, LDicomNet::SendAssociateAccept, LDicomNet::SendAssociateRequest, LDicomNet::OnReceiveAssociateAccept, LDicomNet::OnReceiveAssociateRequest
Topics:	Creating a DICOM Associate Connection
	Receiving Messages
	Diagram of a Basic SCU-SCP Set-up
	Creating an SCU
	Creating an SCP

Example

//LMyDicomNet is a class derived from LDicomNet

//In class LMyDicomNet, all events (virtual functions OnXXX()) have been

//overridden so that they can be processed. Each event displays a MessageBox

//identifying the event, the IP that generated the event, the IP that received the event, and

//any other relevant data.

//For the entire derived class, see (hyperlink)LMyDicomNet class

L_VOID   LMyDicomNet::OnReceiveAssociateReject(L_UCHAR nResult, L_UCHAR nSource, L_UCHAR nReason)
{
   //Client receives this event
   CString strMsg;
   strMsg.Format(TEXT("*** OnReceiveAssociateReject ***\nResult[%d]\nSource[%d]\nReason[%d]"),
      nResult, nSource, nReason);
   AfxMessageBox(strMsg);
}