ConvertInterfaceLuidToNameW-Funktion
Die ConvertInterfaceLuidToNameW-Funktion konvertiert einen lokal eindeutigen Bezeichner (LUID) für eine Netzwerkschnittstelle in den Namen der Unicode-Schnittstelle.
Hinweis
Die ConvertInterfaceXxx-API-Familie listet Bezeichner über alle an TCP/IP gebundenen Schnittstellen auf, die virtuelle Miniports, Lightweight-Filter, Tunneladapter und physische Schnittstellen umfassen können.
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 Namen der Unicode-Schnittstelle.Länge [in]
Die Länge des Puffers nach Zeichenanzahl, auf die 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 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 gibt diesen Fehler zurück, wenn Entweder InterfaceLuid oder InterfaceNameNULL ist oder Wenn InterfaceLuid ungültig ist. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW 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 ConvertInterfaceLuidToNameW-Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen für die Protokolle IPv6 und IPv4.
Die maximale Länge des Netzwerkschnittstellennamens NDIS_IF_MAX_STRING_SIZE ohne das beendende NULL-Zeichen wird in der Headerdatei "Ntddndis.h" definiert. Die NDIS_IF_MAX_STRING_SIZE ist als die IF_MAX_STRING_SIZE Konstante definiert, die in der Headerdatei "Ifdef.h" 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 ConvertInterfaceLuidToNameA , um eine Netzwerkschnittstellen-LUID in einen ANSI-Schnittstellennamen zu konvertieren.
Anforderungen
Zielplattform |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (einschließlich Netioapi.h) |
Bibliothek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |