ConvertInterfaceLuidToNameA-Funktion (netioapi.h)

Die ConvertInterfaceLuidToNameA-Funktion konvertiert einen lokal eindeutigen Bezeichner (LUID) für eine Netzwerkschnittstelle in den NAMEN der ANSI-Schnittstelle.

Syntax

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToNameA(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PSTR           InterfaceName,
  [in]  SIZE_T         Length
);

Parameter

[in] InterfaceLuid

Ein Zeiger auf eine NET_LUID für eine Netzwerkschnittstelle.

[out] InterfaceName

Ein Zeiger auf einen Puffer, der die NULL-beendete ANSI-Zeichenfolge enthält, die den Schnittstellennamen enthält, wenn die Funktion erfolgreich zurückgegeben wird.

[in] Length

Die Länge des Puffers in Bytes, auf den der Parameter InterfaceName verweist. Dieser Wert muss groß genug sein, um den Schnittstellennamen und das endende NULL-Zeichen aufzunehmen. Die maximal erforderliche Länge ist NDIS_IF_MAX_STRING_SIZE + 1.

Rückgabewert

Bei erfolgreicher Ausführung gibt ConvertInterfaceLuidToNameANETIO_ERROR_SUCCESS zurück. Jeder Nichtzero-Rückgabewert weist auf einen Fehler hin.

Fehlercode Bedeutung
ERROR_INVALID_PARAMETER
Einer der Parameter war ungültig. Dieser Fehler wird zurückgegeben, wenn entweder der Parameter InterfaceLuid oder InterfaceNameNULL lautet oder wenn der Parameter InterfaceLuid ungültig war.
ERROR_NOT_ENOUGH_MEMORY
Für die Verarbeitung dieses Befehls steht nicht genügend Speicherplatz zur Verfügung. Dieser Fehler wird zurückgegeben, wenn die Größe des Puffers, auf den der Parameter InterfaceName verweist, nicht groß genug war, wie im Length-Parameter angegeben, um den Schnittstellennamen zu speichern.

Hinweise

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

Die ConvertInterfaceLuidToNameA-Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen sowohl für das IPv6- als auch für das IPv4-Protokoll. ConvertInterfaceLuidToNameA konvertiert eine Netzwerkschnittstellen-LUID in einen ANSI-Schnittstellennamen.

ConvertInterfaceLuidToNameW konvertiert eine Netzwerkschnittstellen-LUID in einen Unicode-Schnittstellennamen.

Die maximale Länge eines Schnittstellennamens , NDIS_IF_MAX_STRING_SIZE, ohne dass der beendende NULL-Wert in der Headerdatei "Ntddndis.h " deklariert wird. Die NDIS_IF_MAX_STRING_SIZE ist als die IF_MAX_STRING_SIZE Konstante definiert, die in der Headerdatei "Ifdef.h " definiert ist. Die Headerdateien "Ntddndis.h" und "Ifdef.h " werden automatisch in die Headerdatei Netioapi.h eingeschlossen, die automatisch von der Headerdatei Iphlpapi.h eingeschlossen wird. Die Headerdateien "Ntddndis.h", "Ifdef.h" und "Netioapi.h " sollten nie direkt verwendet werden.

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

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex