PC_PRINTER_FREE_BMP

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

Syntax:
call "PC_PRINTER_FREE_BMP" using     printer-handle
                           by value  bmp-id
                           returning status-code
Parameters:
Using call prototype (see Library Routines - Key) Picture (32-bit systems)
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
See Also: