RtlEthernetStringToAddressA-Funktion (ip2string.h)

Artikel
11/20/2024

Die RtlEthernetStringToAddress-Funktion konvertiert eine Zeichenfolgendarstellung einer Ethernet-MAC-Adresse in ein Binärformat der Ethernet-Adresse.

Syntax

NTSYSAPI NTSTATUS RtlEthernetStringToAddressA(
  [in]  PCSTR    S,
  [out] PCSTR    *Terminator,
  [out] DL_EUI48 *Addr
);

Parameter

[in] S

Ein Zeiger auf einen Puffer, der die NULL--terminated string representation of the Ethernet MAC address enthält.

[out] Terminator

Ein Parameter, der einen Zeiger auf das Zeichen empfängt, das die konvertierte Zeichenfolge beendet hat. Dies kann vom Aufrufer verwendet werden, um weitere Informationen aus der Zeichenfolge zu extrahieren.

[out] Addr

Ein Zeiger, auf dem die binäre Darstellung der Ethernet MAC-Adresse gespeichert werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	An die Funktion wurde ein ungültiger Parameter übergeben. Dieser Fehler wird zurückgegeben, wenn die Zeichenfolge, auf die der S--Parameter verweist, keine ordnungsgemäße Zeichenfolgendarstellung einer Ethernet-MAC-Adresse enthält. Dieser Fehlercode ist in der Ntstatus.h Headerdatei definiert.
Andere	Verwenden Sie FormatMessage-, um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Bemerkungen

Die RtlEthernetStringToAddress-funktion wird verwendet, um eine Zeichenfolgendarstellung einer Ethernet-EUI-48-Datenverbindungsschichtadresse (auch als MAC-Adresse bezeichnet) in binäres Format der Ethernet-Adresse zu konvertieren. Die Zeichenfolge stellt eine numerische Ethernet-Adresse dar, die in der Nicht-DIX-Standardnotation "-'' angegeben ist. Der zurückgegebene Wert ist eine Zahl, die für die Verwendung als Ethernet-Adresse geeignet ist. Alle Ethernet-Adressen werden in Netzwerkreihenfolge zurückgegeben (Von links nach rechts sortierte Bytes).

Die Zeichenfolge, auf die der S-Parameter verweist, muss in der Form für eine Ethernet-MAC-Adresszeichenfolge in der Nicht-DIX-Standardnotation "-" dargestellt werden. Die grundlegende Zeichenfolgendarstellung einer Ethernet MAC-Adresse besteht aus 6 Paaren hexadezimaler Zahlen, die durch Gedankenstriche getrennt sind (z. B. F4-CE-46-2D-90-8C).

Bei Erfolg zeigt der Terminator Parameter auf das Zeichen, das die konvertierte Zeichenfolge beendet hat. Dadurch kann eine Anwendung eine Zeichenfolge übergeben, die eine Ethernet-Adresse enthält, sowie zusätzliche Informationen an die RtlEthernetStringToAddress-Funktion übergeben und dann die verbleibenden Informationen analysieren.

RtlEthernetStringToAddress ist eine Komfortfunktion, die nicht erfordert, dass die Windows Sockets-DLL geladen wird, um auf eine in Windows Sockets bereitgestellte Funktion zuzugreifen, um eine Zeichenfolge für die Ethernet-Adresskonvertierung auszuführen.

Wenn unicode oder _UNICODE definiert ist, wird RtlEthernetStringToAddress in RtlEthernetStringToAddressWdefiniert, der Unicode-Version dieser Funktion. Die parameter S und Terminator werden für den PCWSTR Datentyp definiert.

Wenn unicode und _UNICODE nicht definiert sind, wird RtlEthernetStringToAddress für RtlEthernetStringToAddressAdefiniert, die ANSI-Version dieser Funktion. Die parameter S und Terminator werden für den datentyp PCSTR definiert.

Der DL_EUI48 Datentyp wird in der Mstcpip.h Headerdatei definiert.

Anmerkung

Der header ip2string.h definiert RtlEthernetStringToAddress als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 7 [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	ip2string.h (include Mstcpip.h, Ip2string.h)
Library	ntdll.lib
DLL-	ntdll.dll

Siehe auch

RtlEthernetAddressToString-

Freigeben über