INetCfgComponentControl::ApplyRegistryChanges method

The ApplyRegistryChanges method directs the notify object of the network component to apply to the operating system the proposed changes for the component's network configuration state.

Syntax

HRESULT ApplyRegistryChanges(
   void 
);

Parameters

  • **
    None

Return value

Returns zero (S_OK) if successful, indicating that the changes were applied, returns S_FALSE if no changes were made, and returns NETCFG_S_REBOOT if the applied changes require a system reboot. If the INetCfg interface for the current networking configuration was not granted the write lock, ApplyRegistryChanges returns NETCFG_E_NO_WRITE_LOCK. ApplyRegistryChanges can also return other NETCFG_* codes that are defined in Netcfgx.h.

Remarks

The ApplyRegistryChanges method can make changes to the registry to apply the component's network configuration state to the operating system. If the network configuration subsystem previously called the INetCfgComponentSetup::Removing method, ApplyRegistryChanges removes information about the network component from the registry. If the network configuration subsystem previously called the INetCfgComponentSetup::Install method, ApplyRegistryChanges sets information about the network component in the registry. If a user previously entered new parameter information on the component's property page, ApplyRegistryChanges modifies the parameter information in the registry.

Requirements

Target platform

Desktop

Header

Netcfgn.h (include Netcfgn.h)

See also

INetCfg

INetCfgComponentSetup::Install

INetCfgComponentSetup::Removing

 

 

Send comments about this topic to Microsoft