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 methodDescription

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments the reference count.

Release

Decrements the reference count.

 

INetCfgComponent methodDescription

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:

See Also

IEnumNetCfgBindingPath, INetCfgBindingPath, INetCfgComponentBindings

Requirements

Header

Netcfgx.h (include Netcfgx.h)

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft