←Select platform

OnStatus Method

Summary

Called to indicate the status of the Print SCU.

Syntax

C++

public virtual void OnStatus(  
   Leadtools.Dicom.DicomPrintScuStatus status, 
   Leadtools.Dicom.DicomCommandStatusType operationStatus 
)

Public Overridable Sub OnStatus( _ 
   ByVal status As Leadtools.Dicom.DicomPrintScuStatus, _ 
   ByVal operationStatus As Leadtools.Dicom.DicomCommandStatusType _ 
)

public: 
virtual void OnStatus(  
   Leadtools.Dicom.DicomPrintScuStatus status, 
   Leadtools.Dicom.DicomCommandStatusType operationStatus 
)

Parameters

status
Specifies the status of the Print SCU.

operationStatus
When the parameter status is one of the ReceivexxxRsp enumerated status values (such as DicomPrintScuStatus.ReceiveCreateFilmSessionRsp), operationStatus will be either DicomCommandStatusType.Success (in case a Success or Warning status code is specified in the response of the Print SCP) or the Failure status code specified in the response. For all other enumerated values of status, operationStatus is meaningless and is always set to 0.

Remarks

As an example, when the method CreateFilmSession is called to create a Film Session, and assuming that the method succeeds, the callback method OnStatus will be called twice: The first time with status set to DicomPrintScuStatus.SendCreateFilmSessionRQ and operationStatus set to 0, and the second time with status set to DicomPrintScuStatus.ReceiveCreateFilmSessionRsp and operationStatus set to DicomCommandStatusType.Success. When the parameter status is one of the ReceivexxxRsp enumerated status values, the parameter operationStatus is determined as follows:

If the status code specified in the response of the Print SCP is either a Success or Warning status code, operationStatus will be set to DicomCommandStatusType.Success. The method GetLastOperationStatus can be used to obtain the actual status code. If it is really a Success status code, the method will return DicomCommandStatusType.Success; otherwise, it will return the Warning status code.
If a Failure status code is specified in the response of the Print SCP, operationStatus will be set to that Failure status code. The same status code would be returned by the method GetLastOperationStatus.

The implementation of the DicomPrintScu class for this method simply does nothing. In order to make use of this callback method, you should create a new class derived from the DicomPrintScu class and override the method providing the desired implementation.

Example

For an example, refer to Associate.

Requirements

Target Platforms