Freigeben über


ConvertInterfaceNameToLuidW-Funktion (netioapi.h)

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

Syntax

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

Parameter

[in] InterfaceName

Ein Zeiger auf eine MIT NULL beendete Unicode-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 ConvertInterfaceNameToLuidWNETIO_ERROR_SUCCESS zurück. Jeder Nichtzero-Rückgabewert weist auf einen Fehler hin.

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

Hinweise

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

Die ConvertInterfaceNameToLuidW-Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen sowohl für das IPv6- als auch für das IPv4-Protokoll. ConvertInterfaceNameToLuidW konvertiert einen Unicode-Schnittstellennamen in eine LUID.

ConvertInterfaceNameToLuidA konvertiert einen ANSI-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

ConvertInterfaceNameToLuidA

NET_LUID

if_indextoname

if_nametoindex