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.