INetCfgComponentNotifyGlobal::SysNotifyBindingPath method

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

See also

INetCfgBindingPath

INetCfgComponentNotifyGlobal::SysQueryBindingPath

Send comments about this topic to Microsoft