Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The InvalidatePluginmethod 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 Value

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

Header home.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Smartphone 2002 and later

See Also