INetCfgBindingPath
The INetCfgBindingPath interface provides methods that control and retrieve information about a binding path.
The interface identifier (IID) for this interface is IID_INetCfgBindingPath.
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 binding path.
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. |
| INetCfgBindingPath method | Description |
|---|---|
Verifies if the specified binding path is the same as this binding path. |
|
Verifies if this binding path is a subpath of the specified binding path. |
|
Retrieves the current state of a binding path. |
|
Sets the state of a binding path to enabled or disabled. |
|
Retrieves the identifier of a binding path that is unique across operating system reboots. |
|
Retrieves the network component that owns a binding path. |
|
Retrieves the number of network components contained in a binding path. |
|
Retrieves an enumeration of a collection of binding interfaces contained in a binding path. |
Comments
A binding path consists of a string of network components that are connected together by binding interfaces. The component at the top of the binding path owns the path.
Starting with Windows 10, there is a change in how a binding path is reported as enabled or disabled. Prior to Windows 10, for a binding path such as C → B → A, disabling B → A by calling INetCfgBindingPath::Enable(FALSE) would not report C → B → A as disabled by INetCfgBindingPath::Enable. To have it reported as disabled, you must also call INetCfg::Apply. Starting with Windows 10, you call INetCfgBindingPath::Enable(FALSE) to disable B → A, which results in C → B → A being reported as disabled.
Requirements
Header |
Netcfgx.h (include Netcfgx.h) |