ConvertInterfaceLuidToNameA-Funktion
Die ConvertInterfaceLuidToNameA--Funktion konvertiert einen lokal eindeutigen Bezeichner (LUID) für eine Netzwerkschnittstelle in den ANSI-Schnittstellennamen.
Anmerkung
Die ConvertInterface-Xxx--API-Familie listet Bezeichner über alle Schnittstellen auf, die an TCP/IP gebunden sind, was virtuelle Miniports, einfache 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ückgegeben wird, enthält InterfaceName- den ANSI-Schnittstellennamen.Länge [in]
Die Länge des Puffers, auf den der InterfaceName Parameter verweist. Dieser Wert muss groß genug sein, um den Schnittstellennamen und das endende NULL-Zeichen aufzunehmen. 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 diesen Fehler zurück, wenn InterfaceLuid oder InterfaceName-NULL-ist oder wenn InterfaceLuid- ungültig ist. |
STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameA diesen Fehler zurück, wenn der InterfaceName- Puffer nicht so groß wie im Parameter Length angegeben war und daher der Puffer den Schnittstellennamen nicht enthalten konnte. |
Bemerkungen
Die ConvertInterfaceLuidToNameA--Funktion ist protokollunabhängig und arbeitet mit Netzwerkschnittstellen für die IPv6- und IPv4-Protokolle.
Die maximale Länge des Namens für eine Netzwerkschnittstelle, NDIS_IF_MAX_STRING_SIZE, ohne das endende NULL-Zeichen, wird in der Ntddndis.h-Headerdatei definiert. NDIS_IF_MAX_STRING_SIZE ist als IF_MAX_STRING_SIZE Konstante definiert, die in der Headerdatei "Ifdef.h" definiert ist.
Anmerkung
Die Ntddndis.h und Ifdef.h Headerdateien werden automatisch in der Netioapi.h Headerdatei enthalten. Sie sollten niemals die Ntddndis.h und Ifdef.h Headerdateien direkt verwenden.
Verwenden Sie die ConvertInterfaceLuidToNameW--Funktion, um eine LUID der Netzwerkschnittstelle in einen Unicode-Schnittstellennamen zu konvertieren.
Anforderungen
Zielplattform |
universelle |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Kopfball |
Netioapi.h (include Netioapi.h) |
Bibliothek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |