Share via


INetCfgComponentNotifyGlobal::SysNotifyBindingPath method

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

Syntax

HRESULT SysNotifyBindingPath(
  [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, the subsystem first calls the INetCfgComponentNotifyGlobal::SysQueryBindingPath method. For other operations that require notifications, such as enabling and disabling, or removing and updating a binding path, the subsystem only calls SysNotifyBindingPath.

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

INetCfgComponentNotifyGlobal::SysQueryBindingPath

 

 

Send comments about this topic to Microsoft