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

See Also

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

Example

For an example, refer to L_DicomConnect.