L_DicomSendAbort

#include "ltdic.h"

L_INT EXT_FUNCTION L_DicomSendAbort(hNet, nSource, nReason)

HDICOMNET hNet;

/* a DICOM Network handle */

L_UCHAR nSource;

/* source of the abort */

L_UCHAR nReason;

/* reason for the abort */

Sends an Abort message to a connection. This function is available in the Medical Suite Toolkit.

Parameter

Description

hNet

A DICOM Network handle. This is the handle created by calling L_DicomCreateNet.

nSource

The source of the abort. Possible values are:

 

Value

Meaning

 

PDU_ABORT_SOURCE_USER

[0] Service user. (client)

 

PDU_ABORT_SOURCE_PROVIDER

[2] Service provider. (server)

 

nReason

The reason for the abort. If the source of the abort is PDU_ABORT_SOURCE_USER, the reasons for the abort are not significant. If the source of the abort is PDU_ABORT_SOURCE_PROVIDER, the possible values are:

 

Value

Meaning

 

PDU_ABORT_REASON_UNKNOWN

[0] Unknown

 

PDU_ABORT_REASON_UNRECOGNIZED

[1] Unrecognized PDU

 

PDU_ABORT_REASON_UNEXPECTED

[2] Unexpected PDU

 

PDU_ABORT_REASON_UNRECOGNIZED_PARAM

[4] Unrecognized PDU parameter

 

PDU_ABORT_REASON_UNEXPECTED_PARAM

[5] Unexpected PDU parameter

 

PDU_ABORT_REASON_INVALID_PARAM

[6] Invalid PDU parameter value

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

Calling L_DicomSendAbort generates a call to RECEIVEABORTCALLBACK. At this time the DICOM Association is closed.

Please note that it is preferable to close a DICOM Association using the L_DicomSendReleaseRequest and L_DicomSendReleaseResponse. For more information on closing a DICOM Association, refer to Closing a DICOM Associate Connection.

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_DicomSendReleaseResponse, L_DicomSendReleaseRequest

Topics:

Working with DICOM Network Connections

 

Working with DICOM Associate Connections

 

Closing a DICOM Associate Connection

 

Creating a DICOM Associate Connection

 

Sending Messages

Example

/* This example sends an Abort message to a connection */

L_VOID Test(HDICOMNET hNet)
{
   L_DicomSendAbort(hNet, PDU_ABORT_SOURCE_USER, 0);
}