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