Freigeben über


ConvertInterfaceNameToLuidA-Funktion (netioapi.h)

Die ConvertInterfaceNameToLuidA-Funktion konvertiert einen ANSI-Netzwerkschnittstellennamen in den lokal eindeutigen Bezeichner (LUID) für die Schnittstelle.

Syntax

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidA(
  [in]  const CHAR *InterfaceName,
  [out] NET_LUID   *InterfaceLuid
);

Parameter

[in] InterfaceName

Ein Zeiger auf eine NULL-beendete ANSI-Zeichenfolge, die den Netzwerkschnittstellennamen enthält.

[out] InterfaceLuid

Ein Zeiger auf den NET_LUID für diese Schnittstelle.

Rückgabewert

Bei erfolgreicher Ausführung gibt ConvertInterfaceNameToLuidANETIO_ERROR_SUCCESS zurück. Jeder Nichtzero-Rückgabewert weist auf einen Fehler hin.

Fehlercode Bedeutung
ERROR_BUFFER_OVERFLOW
Die Länge des ANSI-Schnittstellennamens war ungültig. Dieser Fehler wird zurückgegeben, wenn der Parameter InterfaceName die maximal zulässige Zeichenfolgenlänge für diesen Parameter überschritten hat.
ERROR_INVALID_NAME
Der Schnittstellenname war ungültig. Dieser Fehler wird zurückgegeben, wenn der Parameter InterfaceName einen ungültigen Namen enthält.
ERROR_INVALID_PARAMETER
Einer der Parameter war ungültig. Dieser Fehler wird zurückgegeben, wenn der Parameter InterfaceLuidNULL lautet.

Hinweise

Die Funktion ConvertInterfaceNameToLuidA ist unter Windows Vista und höher verfügbar.

Die ConvertInterfaceNameToLuidA-Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen für das IPv6- und das IPv4-Protokoll. ConvertInterfaceNameToLuidA konvertiert einen ANSI-Schnittstellennamen in eine LUID.

ConvertInterfaceNameToLuidW konvertiert einen Unicode-Schnittstellennamen in eine LUID.

Die maximale Länge eines Schnittstellennamens , NDIS_IF_MAX_STRING_SIZE, ohne dass der beendende NULL-Wert in der Headerdatei "Ntddndis.h " deklariert wird. Die NDIS_IF_MAX_STRING_SIZE ist als die IF_MAX_STRING_SIZE Konstante definiert, die in der Headerdatei "Ifdef.h " definiert ist. Die Headerdateien "Ntddndis.h" und "Ifdef.h " werden automatisch in die Headerdatei Netioapi.h eingeschlossen, die automatisch von der Headerdatei Iphlpapi.h eingeschlossen wird. Die Headerdateien "Ntddndis.h", "Ifdef.h" und "Netioapi.h " sollten nie direkt verwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile netioapi.h (include Iphlpapi.h)
Bibliothek Iphlpapi.lib
DLL Iphlpapi.dll

Weitere Informationen

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex