RtlEthernetStringToAddressA-Funktion (ip2string.h)

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.

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.

Anforderungen

Siehe auch

RtlEthernetAddressToString-