Share via


INetCfgComponentNotifyBinding::NotifyBindingPath method

The NotifyBindingPath method informs the notify object that a change occurred to the binding path of its network component. This method directs the notify object to perform operations related to the change.

Syntax

HRESULT NotifyBindingPath(
  [in] DWORD              dwChangeFlag,
  [in] INetCfgBindingPath *pncbpItem
);

Parameters

  • dwChangeFlag [in]
    Specifies a mask enumerating the types of binding path changes that occurred. This value can contain a combination of the following types from the BIND_FLAGS1 enumeration.

    Value Description

    NCN_ADD

    Adds the binding path.

    NCN_REMOVE

    Removes the binding path.

    NCN_UPDATE

    Updates the binding path.

    NCN_ENABLE

    Enables the binding path.

    NCN_DISABLE

    Disables the binding path.

     

  • pncbpItem [in]
    Pointer to the INetCfgBindingPath interface of the item involved in the specified change.

Return value

Returns zero (S_OK) if successful; otherwise, returns NETCFG_* codes that are defined in Netcfgx.h.

Remarks

If the network configuration subsystem adds a binding path to the network component that owns the notify object, the subsystem first calls the notify object's INetCfgComponentNotifyBinding::QueryBindingPath method. For other operations that require notifications, such as enabling and disabling, or removing and updating a binding path for the network component that owns the notify object, the subsystem only calls NotifyBindingPath.

A 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

INetCfgBindingPath

INetCfgComponentNotifyBinding::QueryBindingPath

 

 

Send comments about this topic to Microsoft