ConvertInterfaceLuidToNameA-Funktion
Die ConvertInterfaceLuidToNameA-Funktion konvertiert einen lokal eindeutigen Bezeichner (LUID) für eine Netzwerkschnittstelle in den NAMEN der ANSI-Schnittstelle.
Hinweis
Die ConvertInterfaceXxx-API-Familie listet Bezeichner über alle Schnittstellen auf, die an TCP/IP gebunden sind, was virtuelle Miniports, lightweight-Filter, Tunneladapter und physische Schnittstellen umfassen kann.
Syntax
NETIOAPI_API ConvertInterfaceLuidToNameA(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PSTR InterfaceName,
_In_ SIZE_T Length
);
Parameter
InterfaceLuid [in]
Ein Zeiger auf eine NET_LUID Union für eine Netzwerkschnittstelle.InterfaceName [out]
Ein Zeiger auf einen Puffer, der die MIT NULL beendete ANSI-Zeichenfolge enthält. Wenn ConvertInterfaceLuidToNameA erfolgreich zurückgibt, enthält InterfaceName den NAMEN der ANSI-Schnittstelle.Länge [in]
Die Länge des Puffers in Bytes, auf den der Parameter InterfaceName verweist. Dieser Wert muss groß genug sein, um den Schnittstellennamen und das abschließende NULL-Zeichen zu enthalten. Die maximal zulässige Länge ist NDIS_IF_MAX_STRING_SIZE + 1. Weitere Informationen zu NDIS_IF_MAX_STRING_SIZE finden Sie im folgenden Abschnitt "Hinweise".
Rückgabewert
ConvertInterfaceLuidToNameA gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Wenn die Funktion fehlschlägt, gibt ConvertInterfaceLuidToNameA einen der folgenden Fehlercodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Einer der Parameter ist ungültig. ConvertInterfaceLuidToNameA gibt diesen Fehler zurück, wenn Entweder InterfaceLuid oder InterfaceNameNULL ist oder Wenn InterfaceLuid ungültig ist. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameA gibt diesen Fehler zurück, wenn der InterfaceName-Puffer nicht so groß war, wie im Length-Parameter angegeben, und daher konnte der Puffer den Schnittstellennamen nicht enthalten. |
Bemerkungen
Die ConvertInterfaceLuidToNameA-Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen für die Protokolle IPv6 und IPv4.
Die maximale Länge des Namens für eine Netzwerkschnittstelle, NDIS_IF_MAX_STRING_SIZE, ohne dass das null-Zeichen beendet wird, wird in der Headerdatei "Ntddndis.h" definiert. NDIS_IF_MAX_STRING_SIZE wird als die IF_MAX_STRING_SIZE-Konstante definiert, die in der Ifdef.h-Headerdatei definiert ist.
Hinweis
Die Headerdateien "Ntddndis.h" und "Ifdef.h " werden automatisch in die Headerdatei "Netioapi.h " eingeschlossen. Sie sollten die Headerdateien Ntddndis.h und Ifdef.h niemals direkt verwenden.
Verwenden Sie die ConvertInterfaceLuidToNameW-Funktion , um eine Netzwerkschnittstellen-LUID in einen Unicode-Schnittstellennamen zu konvertieren.
Anforderungen
Zielplattform |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (netioapi.h einschließen) |
Bibliothek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |