Network Configuration Return Codes (NETCFG_*)

Methods of Notify Object Interfaces and Network Configuration Interfaces can return the following NETCFG_* codes, which are defined in Netcfgx.h:

Error Codes

  • NETCFG_E_ADAPTER_NOT_FOUND
    Indicates that the physical adapter corresponding to the component is not present on the system.

  • NETCFG_E_ALREADY_INITIALIZED
    Indicates that the INetCfgComponent interface is not expected to be initialized, but it is already initialized. For example, this code is returned if the INetCfgComponent interface is already initialized before the INetCfg::Initialize method has been called.

  • NETCFG_E_MAX_FILTER_LIMIT
    Indicates that the application is trying to install a filter device, but the maximum number of filter devices that the system supports has already been reached.

  • NETCFG_E_NEED_REBOOT
    Indicates that the operation failed, and the system needs to be rebooted. For example, this code is returned if calls to the INetCfgClassSetup::Install or INetCfgClassSetup::DeInstall methods fail.

  • NETCFG_E_NO_WRITE_LOCK
    Indicates that a call to the INetCfgLock::AcquireWriteLock method did not succeed. This code returns if another application currently owns the lock on network configuration.

  • NETCFG_E_NOT_INITIALIZED
    Indicates that the INetCfg interface is expected to be initialized, but it is not yet initialized.

Success Codes

Obsolete Return Codes

The following return codes are obsolete:

NETCFG_E_ACTIVE_RAS_CONNECTIONS

NETCFG_E_COMPONENT_REMOVED_PENDING_REBOOT

NETCFG_E_IN_USE

NETCFG_S_CAUSED_SETUP_CHANGE

 

 

Send comments about this topic to Microsoft