Compartir a través de


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

INetCfg

INetCfgComponent

INetCfgComponentBindings

 

 

Send comments about this topic to Microsoft