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
Target platform |
Desktop |
Header |
Netcfgx.h (include Netcfgx.h) |
See also