GetInfo method (ILPrinter Interface)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

 

Syntax

short GetInfo(VARIANT_BOOL bBasicPrintManagement, VARIANT_BOOL bColorPrintManagement);

Overview

Refer to Print Management SCU.

Remarks

The GetInfo method queries the Print SCP for information about the printer.

The method will not return until it receives the response of the Print SCP or an error occurs. The status code specified in the response of the Print SCP is given by the LastOperationStatus property. When the return value of the method is 0, then this means that the required printer information was retrieved successfully, with either a Success or Warning status code in the response of the Print SCP.

Before calling the method, the required printer information can be specified using the RequiredInfo property. Once the printer information is retrieved successfully, it can be obtained by accessing the various properties. Notice that any property that specifies the Value of an Attribute will be updated, even if the Attribute wasn’t specified before calling the method.

The Printer SOP Class is included in each of the three Meta SOP Classes (the Basic Grayscale Print Management Meta SOP Class, the Basic Color Print Management Meta SOP Class, and the Pull Stored Print Management Meta SOP Class). The parameters bBasicPrintManagement and bColorPrintManagement recommend the Meta SOP Class to be specified in the request to the Print SCP. However, unless the Meta SOP Class specified by these parameters is supported on the Association, it will not be specified in the request and the method will choose a supported Meta SOP Class instead. Therefore, if only one Meta SOP Class is supported, the method will always choose it irrespective of the values of these parameters. The parameter bBasicPrintManagement selects between the Basic Print Management Meta SOP Classes and the Pull Stored Print Management Meta SOP Class, while the parameter bColorPrintManagement selects between the Basic Grayscale Print Management Meta SOP Class and the Basic Color Print Management Meta SOP Class.

See Also

Elements:

RequiredInfo property, LastOperationStatus property, OnPrinterReport event, Get method

Topics:

DICOM Print Management SCU: Printer