ConvertInterfaceLuidToNameW-Funktion
Die ConvertInterfaceLuidToNameW--Funktion konvertiert einen lokal eindeutigen Bezeichner (LUID) für eine Netzwerkschnittstelle in den Unicode-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 ConvertInterfaceLuidToNameW(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceName,
_In_ SIZE_T Length
);
Parameter
InterfaceLuid [in]
Ein Zeiger auf eine NET_LUID Union für die Netzwerkschnittstelle.InterfaceName [out]
Ein Zeiger auf einen Puffer, der die MIT NULL beendete Unicode-Zeichenfolge enthält. Wenn ConvertInterfaceLuidToNameW erfolgreich zurückgegeben wird, enthält InterfaceName- den Unicode-Schnittstellennamen.Länge [in]
Die Länge des Puffers nach Zeichenanzahl, auf die 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
ConvertInterfaceLuidToNameW gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Wenn die Funktion fehlschlägt, gibt ConvertInterfaceLuidToNameW einen der folgenden Fehlercodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Einer der Parameter ist ungültig. ConvertInterfaceLuidToNameW diesen Fehler zurück, wenn InterfaceLuid oder InterfaceName-NULL-ist oder wenn InterfaceLuid- ungültig ist. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW 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 ConvertInterfaceLuidToNameW--Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen für die IPv6- und IPv4-Protokolle.
Die maximale Länge des Netzwerkschnittstellennamens, NDIS_IF_MAX_STRING_SIZE, ohne das endende NULL-Zeichen, wird in der Ntddndis.h-Headerdatei definiert. Die 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 ConvertInterfaceLuidToNameA-, um eine LUID der Netzwerkschnittstelle in einen ANSI-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 |