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

See also

IEnumNetCfgBindingInterface

INetCfgBindingInterface

INetCfgBindingPath

Send comments about this topic to Microsoft