L_DicomSendAssociateReject

#include "ltdic.h"

L_LTDIC_API L_INT L_DicomSendAssociateReject(hNet, nResult, nSource, nReason)

HDICOMNET hNet;

/* a DICOM Network handle */

L_UCHAR nResult;

/* type of rejection */

L_UCHAR nSource;

/* source of rejection */

L_UCHAR nReason;

/* reason for rejection */

Sends an Associate Reject message to a connection. This function is available in the PACS Imaging 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. 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. Possible values are:

 

Value

Meaning

 

PDU_REJECT_REASON_CONGESTION

[1] Temporary congestion.

 

PDU_REJECT_REASON_LIMIT

[2] Local client limit exceeded.

Returns

DICOM_SUCCESS

The function was successful.

>0

An error occurred. Refer to Return Codes.

Comments

L_DicomSendAssociateReject is sent by the SCP in response to an L_DicomSendAssociateRequest call placed by an SCU. It generates a call to RECEIVEASSOCIATEREJECTCALLBACK on the SCU.

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:

RECEIVEASSOCIATEREJECTCALLBACK, L_DicomCreateAssociate, L_DicomSendAssociateRequest, L_DicomSendAssociateAccept, L_DicomSendReleaseRequest

Topics:

Working with DICOM Network Connections

 

Working with DICOM Associate Connections

 

Creating a DICOM Associate Connection

 

Creating an SCP

 

Diagram of a Basic SCU-SCP Set-Up

 

Sending Messages

Example

For an example, refer to L_DicomListen.