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

See also

INetCfgBindingPath

Send comments about this topic to Microsoft