This documentation is archived and is not being maintained.

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.

ValueDescription

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

Show: