GetPrinterConfiguration Method

Summary

Queries the Print SCP for the printer configuration information and returns the retrieved information.

Syntax

C++

public DicomDataSet GetPrinterConfiguration()

Public Function GetPrinterConfiguration() As DicomDataSet

public: 
DicomDataSet^ GetPrinterConfiguration();

Return Value

A DicomDataSet object the holds the retrieved printer configuration information. The information is sent by the Print SCP as one or more Items in a Printer Configuration Sequence (2000,001E). The various members of the DicomDataSet class can be used to investigate the retrieved information.

Remarks

Two of the exceptions that can be thrown by this method are:

Exception Type	Condition
DicomExceptionCode.PrintSCUFailureStatus	The response of the Print SCP specifies a Failure status code.
DicomExceptionCode.PrintSCUClassNotSupported	The Printer Configuration Retrieval SOP Class is not supported on the Association.

The method will not return until it receives the response of the Print SCP, or an error occurs. The method GetLastOperationStatus can be used to obtain the status code specified in the response of the Print SCP. If the method GetPrinterConfiguration is successful, the printer configuration information was retrieved successfully, with either a Success or Warning status code in the response of the Print SCP.

Example

For an example, refer to Associate.

Requirements

Target Platforms