BEFORESENDCOMMANDSET

Summary

Notifies a connection before the Command Set portion of a DIMSE L_DicomSendXXXResponse is transmitted.

Syntax

L_VOID pEXT_CALLBACK YourFunction (hNet, hCS, pUserData)

Parameters

HDICOMNET hNet

A DICOM Network handle.

HDICOMDS hCS

An HDICOMDS containing the Command Set portion of a DIMSE L_DicomSendXXXResponse message.

L_VOID *pUserData

Void pointer to be used to access a variable or structure containing data that the callback requires. This gives a way to receive data indirectly from the function that fires this callback.

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within the callback.

Returns

None.

Comments

A call to this function is generated in each of the following functions before the Command Set portion is sent:

• L_DicomSendCStoreResponse
• L_DicomSendCFindResponse
• L_DicomSendCGetResponse
• L_DicomSendCMoveResponse
• L_DicomSendCEchoResponse
• L_DicomSendNReportResponse
• L_DicomSendNGetResponse
• L_DicomSendNSetResponse
• L_DicomSendNActionResponse
• L_DicomSendNCreateResponse
• L_DicomSendNDeleteResponse

This allows an SCP to add/remove DICOM elements to the Command Set cs prior to transmission.

This is useful for adding optional status elements for providing additional status information including:

• (0000,0901) Offending Element
• (0000,0902) Error Comment
• (0000,0903) Error ID
• (0000,0002) Affected SOPClassUID
• (0000,1000) Affected SOPInstanceUID
• (0000,1005) Attribute Identifier List
• (0000,1002) Event Type ID
• (0000,1008) Action Type ID

To use this callback function, BEFORESENDCOMMANDSET must be set using L_DicomSetCallbackExt.

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

• L_DicomSendCStoreResponse
• L_DicomSendCFindResponse
• L_DicomSendCGetResponse
• L_DicomSendCMoveResponse
• L_DicomSendCEchoResponse
• L_DicomSendNReportResponse
• L_DicomSendNGetResponse
• L_DicomSendNSetResponse
• L_DicomSendNActionResponse
• L_DicomSendNCreateResponse
• L_DicomSendNDeleteResponse

Topics

• Working with DICOM Network Connections
• Working with DICOM Associate Connections
• Creating a DICOM Associate Connection
• Creating an SCP
• Diagram of a Basic Client-Server Set-Up
• Sending Messages