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: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) |
See also
INetCfgComponentControl::ApplyRegistryChanges