INetCfgComponentNotifyBinding::NotifyBindingPath method

Article
06/19/2017

The NotifyBindingPath method informs the notify object that a change occurred to the binding path of its network component. This method directs the notify object to perform operations related to the change.

Syntax

HRESULT NotifyBindingPath(
  [in] DWORD              dwChangeFlag,
  [in] INetCfgBindingPath *pncbpItem
);

Parameters

dwChangeFlag [in]
Specifies a mask enumerating the types of binding path changes that occurred. This value can contain a combination of the following types from the BIND_FLAGS1 enumeration.

Value	Description
NCN_ADD	Adds the binding path.
NCN_REMOVE	Removes the binding path.
NCN_UPDATE	Updates the binding path.
NCN_ENABLE	Enables the binding path.
NCN_DISABLE	Disables the binding path.

pncbpItem [in]
Pointer to the INetCfgBindingPath interface of the item involved in the specified change.

Return value

Returns zero (S_OK) if successful; otherwise, returns NETCFG_* codes that are defined in Netcfgx.h.

Remarks

If the network configuration subsystem adds a binding path to the network component that owns the notify object, the subsystem first calls the notify object's INetCfgComponentNotifyBinding::QueryBindingPath method. For other operations that require notifications, such as enabling and disabling, or removing and updating a binding path for the network component that owns the notify object, the subsystem only calls NotifyBindingPath.

A notify object can use the provided binding path to obtain binding interfaces and network components that belong to the binding path.

Requirements

Target platform	Desktop
Header	Netcfgn.h (include Netcfgn.h)

Share via