INetCfgComponentNotifyBinding::QueryBindingPath method
The QueryBindingPath method informs the notify object that a binding path is about to be added to its network component. This method directs the notify object to evaluate the change and to accept or reject it.
Syntax
HRESULT QueryBindingPath(
[in] DWORD dwChangeFlag,
[in] INetCfgBindingPath *pncbpItem
);
Parameters
dwChangeFlag [in]
Specifies a mask enumerating the types of binding path changes that are about to occur. This value can contain a combination of the following types from the BIND_FLAGS1 enumeration:Value Description NCN_ADD
Add the binding path.
NCN_ENABLE
Enable the binding path.
NCN_DISABLE
Disable the binding path.
pncbpItem [in]
Pointer to the INetCfgBindingPath interface of the binding path that is about to be added.
Return value
Returns zero (S_OK) if successful, indicating that the notify object accepts the proposed change. Returns NETCFG_S_DISABLE_QUERY if the notify object accepts the proposed binding path, but specifies that the network configuration subsystem must disable the binding path. Otherwise, returns other NETCFG_* codes that are defined in Netcfgx.h.
Remarks
The notify object can use the provided binding path to obtain binding interfaces and network components that belong to the binding path as follows:
Call the INetCfgBindingPath::EnumBindingInterfaces method to obtain the binding path's collection of binding interfaces.
Call the methods of the IEnumNetCfgBindingInterface interface to enumerate the INetCfgBindingInterface interfaces.
Call INetCfgBindingInterface::GetUpperComponent and INetCfgBindingInterface::GetLowerComponent methods to obtain components that are attached to the binding interface.
Requirements
Target platform |
Desktop |
Header |
Netcfgn.h (include Netcfgn.h) |
See also