GpiQueryBitmapHandle

This function returns the handle of the bit map currently tagged with the specified local identifier (lcid).

Syntax
 hbm = GpiQueryBitmapHandle(hps, lLcid); 

Parameters

 * hps (HPS) - input : Presentation-space handle.


 * lLcid (LONG) - input : Local identifier.
 * It must be greater than 0 and less than 255.

Return Code

 * hbm (HBITMAP) - returns : Bit-map handle.
 * <>0 : Bit-map handle
 * GPI_ERROR : Error.

Errors
Possible returns from WinGetLastError
 * PMERR_INV_HPS (0x207F) : An invalid presentation-space handle was specified.
 * PMERR_PS_BUSY (0x20F4) : An attempt was made to access the presentation space from more than one thread simultaneously.
 * PMERR_INV_SETID (0x20CA) : An invalid setid parameter was specified.
 * PMERR_ID_HAS_NO_BITMAP (0x2036) : No bit map was tagged with the setid specified on a GpiQueryBitmapHandle function.

Remarks
An error is raised if a bit map is not currently tagged with the specified lLcid.

Example Code
This example uses GpiQueryBitmapHandle to return the handle of the bit map currently tagged with the specified local identifier (lcid) set byGpiSetBitmapId. 
 * 1) define INCL_GPIBITMAPS /* Bit-map functions */
 * 2) include 

HBITMAP hbm; /* bit-map handle */ HPS hps; /* presentation-space handle */ LONG lLcid; /* local identifier */

hbm = GpiQueryBitmapHandle(hps, lLcid); 

Related Functions

 * GpiSetBitmapId