INetCfgComponentControl::Initialize method
The Initialize method initializes the notify object of the network component and provides access to the component and to all aspects of network configuration.
Syntax
HRESULT Initialize(
[in] INetCfgComponent *pnccItem,
[in] INetCfg *pNetCfg,
[in] BOOL fInstalling
);
Parameters
pnccItem [in]
Pointer to the INetCfgComponent interface for accessing the network component that owns the notify object.pNetCfg [in]
Pointer to the INetCfg interface for accessing all aspects of network configuration.fInstalling [in]
Specifies a Boolean value that is TRUE if the operating system currently installs the network component and FALSE if the component is already installed.
Return value
Returns zero (S_OK) if successful; otherwise, returns NETCFG_* codes that are defined in Netcfgx.h.
Remarks
The notify object can use the pNetCfg pointer to the INetCfg interface to access information for the current networking configuration.
The notify object can use the pnccItem pointer to the INetCfgComponent interface to access information for the network component that owns the notify object. For example, the notify object can call the QueryInterface method of INetCfgComponent to obtain a pointer to the INetCfgComponentBindings interface for the network component. The notify object can use this interface to control binding and to retrieve binding information for the network component.
Requirements
Target platform |
Desktop |
Header |
Netcfgn.h (include Netcfgn.h) |
See also