Freigeben über


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

Siehe auch

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid-

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex-

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA-

ConvertInterfaceNameToLuidW-

NET_LUID