Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPILOGCOLORTABLE
 
BOOL GpiUnrealizeColorTable(hps)
HPS hps;    /* presentation-space handle */
 
The GpiUnrealizeColorTable function "unrealizes" the logical color table.
The function has the opposite effect of the GpiRealizeColorTable function.
It restores the default device colors for the physical palette for the
device associated with the given presentation space.
 
The function does not change the logical color table.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_COL_TABLE_NOT_REALIZED
     PMERR_INV_HPS
     PMERR_PS_BUSY
 
See Also
 
GpiRealizeColorTable
 
                                      ♦