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_GPIBITMAPS
 
HBITMAP GpiQueryBitmapHandle(hps, lcid)
HPS hps;      /* presentation-space handle */
LONG lcid;    /* local identifier          */
 
The GpiQueryBitmapHandle function retrieves the handle of the bitmap
currently tagged with the specified local identifier. The function returns a
null handle if a bitmap is not currently tagged with the specified local
identifier.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
lcid       Specifies the local identifier.
 
Return Value
 
The return value is a handle to the bitmap 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_BITMAP_NOT_FOUND
     PMERR_BITMAP_NOT_SELECTED
     PMERR_INV_HPS
     PMERR_INV_SETID
     PMERR_PS_BUSY
 
See Also
 
GpiSetBitmapId, WinGetLastError
 
                                      ♦