Share via


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:

Requirements

Target platform

Desktop

Header

Netcfgn.h (include Netcfgn.h)

See also

IEnumNetCfgBindingInterface

INetCfgBindingInterface

INetCfgBindingPath

 

 

Send comments about this topic to Microsoft