INetCfgClassSetup

The INetCfgClassSetup interface provides methods that install or remove network components of a specified type.

The interface identifier (IID) for this interface is IID_INetCfgClassSetup.

When to Implement

It is not necessary to implement the methods of this interface. They are implemented in Netcfgx.dll.

When to Use

Use this interface to either install or remove network components.

Methods

The following methods are listed in Vtable order:

IUnknown methodDescription

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments the reference count.

Release

Decrements the reference count.

 

INetCfgClassSetup methodDescription

SelectAndInstall

Displays a dialog that a user can use to select a network component of a particular class for installation.

Install

Informs a class of network components to install the component specified by an identifier.

DeInstall

Removes the specified network component from the registry.

 

Comments

If an application did not already call INetCfgLock::AcquireWriteLock to provide a client control over network configuration, the methods of INetCfgClassSetup return NETCFG_E_NO_WRITE_LOCK.

Calls to any INetCfgClassSetup methods within a notify object's implementation of any of the following interface methods could return E_FAIL:

INetCfgComponentSetup

INetCfgComponentNotifyGlobal

INetCfgComponentPropertyUi

INetCfgComponentNotifyBinding

These INetCfgClassSetup methods return E_FAIL if an implemented method of one of the interfaces in the preceding list is not also passed change flags containing one of the following values:

  • NCN_ADD

  • NCN_REMOVE

  • NCN_UPDATE

Notify objects call the QueryInterface method of the INetCfgClass interface to obtain a pointer to INetCfgClassSetup.

See Also

INetCfgClass, INetCfgComponentNotifyBinding, INetCfgComponentNotifyGlobal, INetCfgComponentPropertyUi, INetCfgComponentSetup, INetCfgLock::AcquireWriteLock

Requirements

Header

Netcfgx.h (include Netcfgx.h)

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft