OnBeforeSendCGetResponse Method

Summary

Notifies an implementor before a DicomNet::SendCGetResponse is sent.

Syntax

C++/CLI

public virtual void OnBeforeSendCGetResponse( 
   DicomClient Client, 
   byte presentationID, 
   int messageID, 
   string affectedClass, 
   DicomCommandStatusType status, 
   int remaining, 
   int completed, 
   int failed, 
   int warning, 
   DicomDataSet dataset 
)

public:  
   virtual void OnBeforeSendCGetResponse( 
       DicomClient^ Client, 
      Byte presentationID, 
      Int32 messageID, 
      String^ affectedClass, 
      DicomCommandStatusType^ status, 
      Int32 remaining, 
      Int32 completed, 
      Int32 failed, 
      Int32 warning, 
      DicomDataSet^ dataset 
   )

Parameters

Client

The client this notification applies to.

presentationID

The Presentation Context ID. The ID provides information about both the class type of the data and the Transfer Syntax to use when transferring the data.

messageID

The Message ID. Each message sent by a member of a connection should have a unique ID. Since a member of a connection may send several messages, this ID allows that member to identify when a specific request has been completed.

affectedClass

The class affected by the request. This will be a SOP Class or a Meta SOP Class.

status

The status of the original request.

remaining

The number of remaining instances to search.

completed

The number of instances searched

failed

The number of instances that failed the search.

warning

The number of instances in which warnings occurred.

dataset

A DicomDataSet object that contains the Data Set which contains the information retrieved as a result of the call to SendCGetRequest.

Remarks

Override this method to view or change arguments before a DicomNet::SendCGetResponse is sent.

This can be used with DICOM listening services in the High-level PACS Framework. For example, you can create an assembly that contains the following code, and copy the assembly into the DICOM listening service 'AddIns' folder.

public class SendNotify : NotifySendMessageBase 
{ 
      public override void OnBeforeSendCGetRequest(DicomClient Client, byte presentationID, int messageID, string affectedClass, DicomCommandPriorityType priority, DicomDataSet dataSet) 
      { 
         // View or change parameters 
         base.OnBeforeSendCGetRequest(Client, presentationID, messageID, affectedClass, priority, dataSet); 
      } 
}