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

Header

Netcfgn.h (include Netcfgn.h)

See also

INetCfgBindingPath
INetCfgComponentNotifyBinding::QueryBindingPath

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft