ConvertInterfaceNameToLuidW-Funktion
Die ConvertInterfaceNameToLuidW-Funktion konvertiert einen Unicode-Netzwerkschnittstellennamen in den lokal eindeutigen Bezeichner (LUID) für die 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 ConvertInterfaceNameToLuidW(
_In_ const WCHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parameter
InterfaceName [in]
Ein Zeiger auf eine MIT NULL beendete Unicode-Zeichenfolge, die den Namen der Netzwerkschnittstelle enthält.InterfaceLuid [out]
Ein Zeiger auf die NET_LUID Union für diese Schnittstelle.
Rückgabewert
ConvertInterfaceNameToLuidW gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Wenn die Funktion fehlschlägt, gibt ConvertInterfaceNameToLuidW einen der folgenden Fehlercodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_NAME | Der Schnittstellenname ist ungültig. ConvertInterfaceNameToLuidW gibt diesen Fehler zurück, wenn der Parameter InterfaceName einen ungültigen Namen enthält oder die Länge des Parameters InterfaceName die maximal zulässige Zeichenfolgenlänge für diesen Parameter überschreitet. |
| STATUS_INVALID_PARAMETER | Einer der Parameter ist ungültig. ConvertInterfaceNameToLuidW gibt diesen Fehler zurück, wenn der Parameter InterfaceLuidNULL ist. |
Bemerkungen
Die ConvertInterfaceNameToLuidW-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. 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 die ConvertInterfaceNameToLuidA-Funktion , um einen ANSI-Schnittstellennamen in eine LUID 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 |