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 method | Description |
|---|---|
QueryInterface |
Returns pointers to supported interfaces. |
AddRef |
Increments the reference count. |
Release |
Decrements the reference count. |
| INetCfgClassSetup method | Description |
|---|---|
Displays a dialog that a user can use to select a network component of a particular class for installation. |
|
Informs a class of network components to install the component specified by an identifier. |
|
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:
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) |