RECEIVEABORTCALLBACK

#include "ltdic.h"

L_VOID pEXT_CALLBACK Your Function(hNet, nSource, nReason, UserData)

HDICOMNET hNet;

/* a DICOM Network handle */

L_UCHAR nSource;

/* source of the abort */

L_UCHAR nReason;

/* reason for the abort */

L_VOID * UserData;

/* pointer to additional data */

Notifies a connection that an Abort message was received. This function is available in the Medical Suite Toolkit.

Parameter

Description

hNet

A DICOM Network handle.

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

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 a connection when the peer member of the connection calls L_DicomSendAbort.

To use this callback function, RECEIVEABORTCALLBACK must be set using L_DicomSetCallback.

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_DicomSendAbort, L_DicomSendReleaseRequest, L_DicomSendReleaseResponse, L_DicomSetCallback, RECEIVERELEASEREQUESTCALLBACK, RECEIVERELEASERESPONSECALLBACK

Example

For an example, refer to L_DicomListen.