This documentation is archived and is not being maintained.

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:

ValueDescription

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)

See also

INetCfgBindingPath
INetCfgComponentNotifyGlobal::SysQueryBindingPath

 

 

Send comments about this topic to Microsoft

Show: