INetCfgBindingInterface::GetName method
The GetName method retrieves the name of a binding interface.
Syntax
HRESULT GetName(
[out] LPWSTR *ppszwInterfaceName
);
Parameters
- ppszwInterfaceName [out]
Pointer to a buffer that receives a constant null-terminated string of 16-bit Unicode characters containing the name 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, GetName returns E_POINTER.
Remarks
After notify objects call GetName to retrieve the name of a binding interface, GetName allocates the memory required to store the string that contains the name. After notify objects finish with the name, they must call the COM CoTaskMemFree function to release the memory. For more information about CoTaskMemFree, see the Microsoft Windows SDK.
Names of binding interfaces include TDI and NDIS5.
The network configuration subsystem compares registry strings of the lower range of the interface's upper component, with registry strings of the upper range of the interface's lower component, to determine the interface's name. If the compared strings are identical, they contain this name.
Requirements
Target platform |
Desktop |
Header |
Netcfgx.h (include Netcfgx.h) |