INetCfgComponentSetup::Install method

Article
06/19/2017

The Install method directs the notify object of the network component to perform operations required to install the component.

Syntax

HRESULT Install(
  [in] DWORD dwSetupFlags
);

Parameters

dwSetupFlags [in]
Specifies a mask enumerating the type of installation and the type of operating system from which to install. A notify object can support a combination of values. The bitmask can contain values from the following NETWORK_INSTALL_TIME enumeration:

Value	Description
NSF_PRIMARYINSTALL	Operating system installation.
NSF_POSTSYSINSTALL	Network installation on an operating system that previously did not have networking.

The bitmask can also contain values from the following NETWORK_UPGRADE_TYPE enumeration:

Value	Description
NSF_WIN95_UPGRADE	Upgrade from Windows 95/98/Me.
NSF_WINNT_WKS_UPGRADE	Upgrade from Windows NT 4.0 Workstation.
NSF_WINNT_SVR_UPGRADE	Upgrade from Windows NT 4.0 Server.
NSF_WINNT_SBS_UPGRADE	Upgrade from Windows NT 4.0 Small Business Server.

Return value

Returns zero (S_OK) if successful; otherwise, returns one of the following codes:

Return code	Description
NETCFG_S_REBOOT	A system reboot is required after Install performs installation operations.
NETCFG_E_NEED_REBOOT	A system reboot is required before the component can be installed.

Note The Install method can also return other NETCFG_ Xxx codes that are defined in Netcfgx.h.

Remarks

Install should not modify the registry. Only the INetCfgComponentControl::ApplyRegistryChanges method should make changes to the registry. The network configuration subsystem first calls Install to perform the operations required to install the component and to set a variable specifying that the action notify object performs is an install. The network configuration subsystem then calls ApplyRegistryChanges to set information about the network component in the registry.

Requirements

Target platform	Desktop
Header	Netcfgn.h (include Netcfgn.h)