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

Send comments about this topic to Microsoft