IHomePluginEnvironment::InvalidatePlugin
The InvalidatePlugin method places a request to redraw the plug-in.
Syntax
HRESULT InvalidatePlugin (
HPLUGIN hPlugin,
DWORD dwFlags
);
Parameters
- hPlugin
[in] Handle to the plug-in to be redrawn. - dwFlags
[in] Indicates whether the height or selectability state of the plug-in has changed. If no flag is passed, the value must be 0; if either the height or the selectability of the plug-in changed, the value is IPF_HEIGHT_CHANGED | IPF_SELECTABILITY_CHANGED. (Both flags must be passed together, but only the flag that changed is read.) These flags are described in the following table.Flag Description IPF_HEIGHT_CHANGED Set this flag if the height of the plug-in changed. This flag causes the device to redraw the screen, a process that can drain the device battery quickly if repeated often. IPF_SELECTABILITY_CHANGED Set this flag if the selectability state of the plug-in changed. This flag causes the device to redraw the screen, a process that drains the device battery quickly if repeated often.
Return Values
This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:
- S_OK
Indicates success.
Requirements
Pocket PC: None
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: home.h
See Also
Send Feedback on this topic to the authors