IHomePlugin::Initialize

Article
08/28/2006

The Initialize method initializes the specified plug-in by using the parameters and default information specified in an XML file.

Syntax

HRESULT Initialize (
  HPLUGIN hPlugin,
  IXMLDOMNode * pnodeParams,
  IXMLDOMNode * pnodeDefault
);

Parameters

hPlugin
[in] Handle to the plug-in to be initialized.
pnodeParams
[in] Parameters that specify the form and function of the plug-in; these parameters are defined in an XML file.
pnodeDefault
[in] Default values common to all plug-ins on the device; these values are defined in a block at the top of an XML file.

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.

Remarks

Before Initialize is called, the IObjectWithSite::SetSite method must be used to instantiate the site within which the plug-in is to be contained.

Requirements

Pocket PC: None
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: home.h