WINPRINT-GET-CURRENT-INFO

The WINPRINT-GET-CURRENT-INFO function retrieves information concerning the currently selected printer. A more complete set of information can be retrieved through the WINPRINT-GET-CURRENT-INFO-EX function.

Syntax:

CALL "WIN$PRINTER" USING WINPRINT-GET-CURRENT-INFO                            WINPRINT-SELECTION                    GIVING returnCode

Parameters:

WINPRINT-GET-CURRENT-INFO	Constant
WINPRINT-SELECTION	Group Item	Structure that receives the information. This group item, defined in isprint.def, has the following structure:   01  winprint-selection.     03 winprint-name             pic x(80).     03 winprint-port             pic x(80).     03 winprint-driver           pic x(80).     03 winprint-drv-version      signed-int.     03 winprint-no-of-printers   signed-short.        88 wprterr-no-printers    value -1.     03 winprint-is-default       signed-short.        88 wprt-is-not-default    value 0.        88 wprt-is-default        value 1.     03 winprint-copies           signed-short.     03 winprint-orientation      signed-short.     03 winprint-quality          signed-short.     03 winprint-curr-orientation signed-short.     03 winprint-curr-copies      signed-short.   Note - members not mentioned below are not used by this function.   winprint-name It is the name of the printer   winprint-no-of-printers It is the number of the currently selected printer in the isCOBOL framework.   winprint-is-default It is a flag indicating if the printer is the system's default printer. If it is the default printer, the wprt-is-default condition is set to true, otherwise the wprt-is-not-default is set to true.   winprint-curr-copies Is the number of copies the printer will print with the next job.   winprint-curr-orientation Is the current orientation: portrait or landscape.

Note - If no printer is available in the system, set wprterr-no-printers to true before calling this function in order to avoid errors. winprint-curr-copies and winprint-curr-orientation are returned anyway.

Note - If this function is called before WINPRINT-SETUP, it returns only the following information: winprint-name, winprint-no-of-printers, winprint-is-default, and winprint-job-title. All other fields are set to default values that may not match with the current printer settings.

Return code:

returnCode can be any signed numeric data item and provides additional information:

1	Operation successful.
WPRTERR-UNSUPPORTED	The WIN$PRINTER library routine is not supported.
WPRTERR-BAD-ARG	The WIN$PRINTER library routine has been called with bad parameters.