INetCfgComponentNotifyBinding::NotifyBindingPath method
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) |
See also
INetCfgComponentNotifyBinding::QueryBindingPath