De functie ConvertInterfaceAliasToLuid

De functie ConvertInterfaceAliasToLuid converteert een aliasnaam voor een interface voor een netwerkinterface naar de lokaal unieke id (LUID) voor de interface.

Notitie

De ConvertInterfaceXxx API-serie inventariseert id's voor alle interfaces die zijn gebonden aan TCP/IP, waaronder virtuele miniports, lichtgewicht filters, tunneladapters en fysieke interfaces.

Syntaxis

NETIOAPI_API ConvertInterfaceAliasToLuid(
  _In_  const WCHAR     *InterfaceAlias,
  _Out_       PNET_LUID InterfaceLuid
);

Parameters

• InterfaceAlias [in]
  Een aanwijzer naar een unicode-tekenreeks met null-beëindiging die de aliasnaam van de netwerkinterface bevat.

• InterfaceLuid [out]
  Een aanwijzer naar de NET_LUID-samenvoeging voor de netwerkinterface.

Retourwaarde

ConvertInterfaceAliasToLuid retourneert STATUS_SUCCESS als de functie slaagt. Als de functie mislukt, wordt de parameter InterfaceLuid ingesteld op NULL-en retourneert ConvertInterfaceAliasToLuid de volgende foutcode:

Retourcode	Beschrijving
STATUS_INVALID_PARAMETER	Een van de parameters is ongeldig. ConvertInterfaceAliasToLuid retourneert deze fout als InterfaceAlias of InterfaceLuidNULL-is, of als InterfaceAlias ongeldig is.

Opmerkingen

De functie ConvertInterfaceAliasToLuid is protocolonafhankelijk en werkt met netwerkinterfaces voor zowel de IPv6- als IPv4-protocollen.

Eisen

Doelplatform	Universal
Versie	Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.
Rubriek	Netioapi.h (inclusief Netioapi.h)
Bibliotheek	Netio.lib
IRQL	PASSIVE_LEVEL

Zie ook

ConvertInterfaceGuidToLuid-

ConvertInterfaceIndexToLuid-

ConvertInterfaceLuidToAlias-

ConvertInterfaceLuidToGuid-

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA-

ConvertInterfaceLuidToNameW-

ConvertInterfaceNameToLuidA-

ConvertInterfaceNameToLuidW-

NET_LUID