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
Target platform |
Desktop |
Header |
Netcfgn.h (include Netcfgn.h) |
See also
INetCfgComponentNotifyGlobal::SysQueryBindingPath