GreDeleteBitmap

GreDeleteBitmap deletes the bit map identified by hbm. If the bit map is currently selected into a DC, GreDeleteBitmap returns an error.

This function is supported by the graphics engine.

Syntax
GreDeleteBitmap(hbm, pInstance, lFunction);

Parameters

 * hbm (HBITMAP) - input
 * Bit-map handle.


 * pInstance (PVOID) - input
 * Pointer to instance data.


 * lFunction (ULONG) - input
 * High-order WORD=flags; low-order WORD=NGreDeleteBitmap.

Returns

 * fSuccess (BOOL) - returns
 * Return codes.


 * On completion, the handling routine must return BOOLEAN (fSuccess).


 * TRUE Successful
 * FALSE Error


 * Possible Errors Detected:  When an error is detected, the graphics engine calls WinSetErrorInfo to post the condition. Reasons for failure of this function include:


 * PMERR_BITMAP_IS_SELECTED
 * PMERR_DEV_FUNC_NOT_INSTALLED
 * PMERR_HBITMAP_BUSY
 * PMERR_INSUFFICIENT_MEMORY
 * PMERR_INV_HBITMAP
 * PMERR_INV_HDC
 * PMERR_INV_INFO_TABLE
 * PMERR_INV_LENGTH_OR_COUNT
 * PMERR_INV_SCAN_START


 * Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.

Sample

 * 1) define INCL_GRE_DEVSUPPORT
 * 2) include 

HBITMAP   hbm;        /*  Bit-map handle. */ PVOID     pInstance;  /*  Pointer to instance data. */ ULONG     lFunction;  /*  High-order WORD=flags; low-order WORD=NGreDeleteBitmap. */ BOOL      fSuccess;   /*  Return codes. */

fSuccess = GreDeleteBitmap(hbm, pInstance,            lFunction);