INetCfgComponent
The INetCfgComponent interface provides methods that control and retrieve information about a network component.
The interface identifier (IID) for this interface is IID_INetCfgComponent.
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 control and retrieve information about a network component.
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. |
| INetCfgComponent method | Description |
|---|---|
Retrieves the name of a component that displays in a network connection's property sheet. |
|
Sets the name of a component that displays in a network connection's property sheet. |
|
Retrieves a component's description that displays in a network connection's property sheet. |
|
Retrieves a component's identifier. |
|
Retrieves a component's characteristics. |
|
Retrieves a component's instance GUID. |
|
Retrieves the identifier of a component's Plug and Play device node. |
|
Retrieves the class GUID for a component's type. |
|
Retrieves a component's description for binding operations. |
|
Retrieves the status of a network card. |
|
Opens and retrieves the registry key that contains parameters for a network component. |
|
Displays a component's property sheet so users can modify the component's properties. |
Comments
When notify objects initialize, they receive a pointer to INetCfgComponent. Notify objects use this pointer to access and configure the network components that own them.
A notify object can call the QueryInterface method of INetCfgComponent to obtain a pointer to the INetCfgComponentBindingsinterface for the network component. The notify object can use this interface to control binding and to retrieve binding information for the network component.
A notify object can call the following methods to retrieve binding paths to which the network component belongs:
Methods of the IEnumNetCfgBindingPath interface that enumerate the INetCfgBindingPath interfaces
See Also
IEnumNetCfgBindingPath, INetCfgBindingPath, INetCfgComponentBindings
Requirements
Header |
Netcfgx.h (include Netcfgx.h) |