Skip to content

Latest commit

 

History

History
141 lines (90 loc) · 3.96 KB

nf-netioapi-convertinterfacealiastoluid.md

File metadata and controls

141 lines (90 loc) · 3.96 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:netioapi.ConvertInterfaceAliasToLuid
ConvertInterfaceAliasToLuid function (netioapi.h)
Converts an interface alias name for a network interface to the locally unique identifier (LUID) for the interface.
ConvertInterfaceAliasToLuid
ConvertInterfaceAliasToLuid function [IP Helper]
iphlp.convertinterfacealiastoluid
netioapi/ConvertInterfaceAliasToLuid
iphlp\convertinterfacealiastoluid.htm
IpHlp
7fa80938-d475-4ace-b463-a53aac26e88b
12/05/2018
ConvertInterfaceAliasToLuid, ConvertInterfaceAliasToLuid function [IP Helper], iphlp.convertinterfacealiastoluid, netioapi/ConvertInterfaceAliasToLuid
netioapi.h
Iphlpapi.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Iphlpapi.lib
Iphlpapi.dll
Windows
19H1
ConvertInterfaceAliasToLuid
netioapi/ConvertInterfaceAliasToLuid
c++
APIRef
kbSyntax
DllExport
Iphlpapi.dll
ConvertInterfaceAliasToLuid

ConvertInterfaceAliasToLuid function

-description

The ConvertInterfaceAliasToLuid function converts an interface alias name for a network interface to the locally unique identifier (LUID) for the interface.

-parameters

-param InterfaceAlias [in]

A pointer to a NULL-terminated Unicode string containing the alias name of the network interface.

-param InterfaceLuid [out]

A pointer to the NET_LUID for this interface.

-returns

On success, ConvertInterfaceAliasToLuid returns NO_ERROR. Any nonzero return value indicates failure and a NULL is returned in the InterfaceLuid parameter.

Error code Meaning
ERROR_INVALID_PARAMETER
One of the parameters was invalid. This error is returned if either the InterfaceAlias or InterfaceLuid parameter was NULL or if the InterfaceAlias parameter was invalid.

-remarks

The ConvertInterfaceAliasToLuid function is available on Windows Vista and later.

The ConvertInterfaceAliasToLuid function is protocol independent and works with network interfaces for both the IPv6 and IPv4 protocol.

-see-also

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex