Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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. |
|
Der Schnittstellenname war ungültig. Dieser Fehler wird zurückgegeben, wenn der Parameter InterfaceName einen ungültigen Namen enthält. |
|
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 |