This documentation is archived and is not being maintained.

INetCfgComponentSetup::Install method

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:

ValueDescription

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:

ValueDescription

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 codeDescription
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)

See also

INetCfgComponentControl::ApplyRegistryChanges

 

 

Send comments about this topic to Microsoft

Show: