WINPRINT-GET-SETTINGS

This operation code retrieves information about the destination device.

Note: The buffer is derived from the (Microsoft) DEVNAMES and DEVMODE structures, with the latter structure also containing space for vendor-specific information. Unlike the other information, this vendor-specific information is not translated into a COBOL character set automatically, as ACUCOBOL-GT cannot ascertain what this area will contain. If you need to process this information, you need to perform the character translation yourself.

Usage

CALL "WIN$PRINTER"
    USING WINPRINT-GET-SETTINGS, BUFFER
    GIVING RESULT

Return Values

This operation returns the number of bytes used in the buffer to hold the spooler's configuration settings.

The number of bytes needed to hold the configuration can change when new settings are selected by the user, often by several hundred bytes. You should allow for a wide range of configuration sizes. Experiments suggest that 1000 bytes is adequate to hold typical configurations, but there is no guaranteed upper boundary.

Comments

The parameter, BUFFER, is a PIC X(n) data item containing the spooler's current configuration. BUFFER should be the second argument to WIN$PRINTER. The spooler's configuration includes information about the destination device, its paper size, and page orientation. It does not include information about the current font selection. The information stored in the buffer is binary data that corresponds to some internal structures used by Windows. This information should be left unchanged. This operation should be called before calling WINPRINT_SET_SETTINGS.

Note: This operation is not supported in ACUCOBOL-GT's Thin Client environment. Use the WINPRINT-GET-PRINTER-INFO-EX operation instead.