Freigeben über


ConvertInterfaceIndexToLuid-Funktion (netioapi.h)

Die ConvertInterfaceIndexToLuid-Funktion konvertiert einen lokalen Index für eine Netzwerkschnittstelle in den lokal eindeutigen Bezeichner (LUID) für die Schnittstelle.

Syntax

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PNET_LUID   InterfaceLuid
);

Parameter

[in] InterfaceIndex

Der lokale Indexwert für eine Netzwerkschnittstelle.

[out] InterfaceLuid

Ein Zeiger auf die NET_LUID für diese Schnittstelle.

Rückgabewert

Bei Erfolg gibt ConvertInterfaceIndexToLuid NO_ERROR zurück. Jeder Rückgabewert ungleich null gibt einen Fehler an, und im Parameter InterfaceLuid wird null zurückgegeben.

Fehlercode Bedeutung
ERROR_FILE_NOT_FOUND
Die angegebene Datei wurde nicht gefunden. Dieser Fehler wird zurückgegeben, wenn die vom Parameter InterfaceIndex angegebene Netzwerkschnittstelle auf dem lokalen Computer kein Wert war.
ERROR_INVALID_PARAMETER
Einer der Parameter war ungültig. Dieser Fehler wird zurückgegeben, wenn der Parameter InterfaceLuidNULL ist oder wenn der Parameter InterfaceIndex ungültig war.

Hinweise

Die ConvertInterfaceIndexToLuid-Funktion ist unter Windows Vista und höher verfügbar.

Die ConvertInterfaceIndexToLuid-Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen für das IPv6- und IPv4-Protokoll.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile netioapi.h (include Iphlpapi.h)
Bibliothek Iphlpapi.lib
DLL Iphlpapi.dll

Weitere Informationen

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex