IHomePluginEnvironment::InvalidatePlugin

Windows Mobile 6.5
4/8/2010

The InvalidatePlugin method places a request to redraw the plug-in.


HRESULT InvalidatePlugin (
  HPLUGIN hPlugin,
  DWORD dwFlags 
);

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.

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

Indicates success.

Headerhome.h
Windows Embedded CEWindows CE 3.0 and later
Windows MobileSmartphone 2002 and later

Community Additions

Show: