INetCfgBindingInterface::GetUpperComponent method

The GetUpperComponent method retrieves the network component that connects to the upper part of a binding interface.

Syntax

HRESULT GetUpperComponent(
  [out, optional] INetCfgComponent **ppnccItem
);

Parameters

• ppnccItem [out, optional]
  Pointer to a buffer that receives a pointer to the INetCfgComponent interface. This INetCfgComponent can access the network component that connects to the upper part of a binding interface.

Return value

Returns zero (S_OK) if successful; otherwise, returns NETCFG_* codes that are defined in Netcfgx.h. If the returned pointer points to NULL, GetUpperComponent returns E_POINTER.

Remarks

For binding purposes, a component closer to the wire (that is, the actual network) is considered as a lower component, while a component closer to the application layer is considered as an upper component. In other words, network components have the following binding order:

Application > Client > Service > Transport > Card > Network

Requirements

See also

INetCfgComponent

Send comments about this topic to Microsoft