INetCfgComponentNotifyGlobal::SysQueryBindingPath method
The SysQueryBindingPath method informs the notify object of the network component that the addition of a binding path is about to occur. This method also directs the object to evaluate the change and to accept or reject it.
Syntax
HRESULT SysQueryBindingPath(
[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
Adds the binding path.
NCN_ENABLE
Enables the binding path.
NCN_DISABLE
Disables 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 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.
Requirements
Target platform |
Desktop |
Header |
Netcfgn.h (include Netcfgn.h) |
See also