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 Medical Suite 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

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);
}