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: |
|
Topics: |
|
|
|
|
|
|
|
|
Example
/* This example sends an Abort message to a connection */
L_VOID Test(HDICOMNET hNet)
{
L_DicomSendAbort(hNet, PDU_ABORT_SOURCE_USER, 0);
}