PC_PRINTER_FREE_BMP

Frees a bitmap from memory, releasing its image and palette back to the operating system.

Restriction: This routine is not currently supported on UNIX platforms.

Syntax:

call "PC_PRINTER_FREE_BMP" using     printer-handle
                           by value  bmp-id
                           returning status-code

Parameters:

	Using call prototype (see Key)	Picture
`printer-handle`	cblt-x4-comp5	pic x(4) comp-5.
`bmp-id`	cblt-x4-comp5	pic x(4) comp-5.
`status-code`	See Library Routines - Key

On Entry:

printer-handle: The printer handle returned when the printer was opened.
bmp-id: The unique id of the loaded bitmap, returned when the bitmap was loaded.

On Exit:

status-code

Printer status code:

0	Successful
3	Printer device not open
20	Failed to free bitmap

Example:

call "PC_PRINTER_FREE_BMP" using     printer-handle
                           by value  bmp-idlogo
                           returning printer-retcode