INetCfgComponentNotifyGlobal::SysNotifyBindingPath method

Article
06/19/2017

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

Syntax

HRESULT SysNotifyBindingPath(
  [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, the subsystem first calls the INetCfgComponentNotifyGlobal::SysQueryBindingPath method. For other operations that require notifications, such as enabling and disabling, or removing and updating a binding path, the subsystem only calls SysNotifyBindingPath.

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