OnStatus Method

C#
Visual Basic
WinRT C#
Objective-C
Java
WinRT JavaScript
C++

public virtual void OnStatus( 
   DicomPrintScuStatus status,
   DicomCommandStatusType operationStatus
)

'Declaration

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

'Usage

Dim instance As DicomPrintScu
Dim status As DicomPrintScuStatus
Dim operationStatus As DicomCommandStatusType
 
instance.OnStatus(status, operationStatus)

public virtual void OnStatus( 
   DicomPrintScuStatus status,
   DicomCommandStatusType operationStatus
)

 function Leadtools.Dicom.DicomPrintScu.OnStatus( 
   status ,
   operationStatus 
)

public:
virtual void OnStatus( 
   DicomPrintScuStatus status,
   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.

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.

For an example, refer to Associate.

Target Platforms

Reference

DicomPrintScu Class
DicomPrintScu Members
GetLastOperationStatus Method