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
GetDisplayName	Retrieves the name of a component that displays in a network connection's property sheet.
SetDisplayName	Sets the name of a component that displays in a network connection's property sheet.
GetHelpText	Retrieves a component's description that displays in a network connection's property sheet.
GetId	Retrieves a component's identifier.
GetCharacteristics	Retrieves a component's characteristics.
GetInstanceGuid	Retrieves a component's instance GUID.
GetPnpDevNodeId	Retrieves the identifier of a component's Plug and Play device node.
GetClassGuid	Retrieves the class GUID for a component's type.
GetBindName	Retrieves a component's description for binding operations.
GetDeviceStatus	Retrieves the status of a network card.
OpenParamKey	Opens and retrieves the registry key that contains parameters for a network component.
RaisePropertyUi	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:

• INetCfgComponentBindings::EnumBindingPaths

• Methods of the IEnumNetCfgBindingPath interface that enumerate the INetCfgBindingPath interfaces

See Also

IEnumNetCfgBindingPath, INetCfgBindingPath, INetCfgComponentBindings

Requirements

Header

Netcfgx.h (include Netcfgx.h)

 

 

Send comments about this topic to Microsoft