Share via


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

IsSamePathAs

Verifies if the specified binding path is the same as this binding path.

IsSubPathOf

Verifies if this binding path is a subpath of the specified binding path.

IsEnabled

Retrieves the current state of a binding path.

Enable

Sets the state of a binding path to enabled or disabled.

GetPathToken

Retrieves the identifier of a binding path that is unique across operating system reboots.

GetOwner

Retrieves the network component that owns a binding path.

GetDepth

Retrieves the number of network components contained in a binding path.

EnumBindingInterfaces

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)

 

 

Send comments about this topic to Microsoft