RtlEthernetAddressToStringA-Funktion (ip2string.h)

  • Artikel

Die RtlEthernetAddressToString-Funktion konvertiert eine binäre Ethernet-Adresse in eine Zeichenfolgendarstellung der Ethernet-MAC-Adresse.

Syntax

NTSYSAPI PSTR RtlEthernetAddressToStringA(
  [in]  const DL_EUI48 *Addr,
  [out] PSTR           S
);

Parameter

[in] Addr

Die Ethernet-Adresse im Binärformat. Die Ethernet-Adresse befindet sich in der Netzwerkreihenfolge (Byte von links nach rechts sortiert).

[out] S

Ein Zeiger auf einen Puffer, in dem die NULL-endende Zeichenfolgendarstellung der Ethernet-Adresse gespeichert werden soll. Dieser Puffer sollte groß genug sein, um mindestens 18 Zeichen zu enthalten.

Rückgabewert

Ein Zeiger auf das NULL-Zeichen, das am Ende der Zeichenfolgendarstellung der Ethernet-MAC-Adresse eingefügt wird. Dies kann vom Aufrufer verwendet werden, um einfach weitere Informationen an die Zeichenfolge anzufügen.

Hinweise

Die RtlEthernetAddressToString-Funktion wird verwendet, um eine binäre Ethernet-Adresse in die Zeichenfolgendarstellung der Ethernet-Adresse im Ethernet-EUI-48-Datenverbindungsschicht-Adressformat (auch bekannt als MAC-Adresse) zu konvertieren. Die Zeichenfolge stellt eine numerische Ethernet-Adresse dar, die in der Nicht-DIX-Standardnotation "-'' ausgedrückt wird.

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

RtlEthernetAddressToString ist eine Komfortfunktion, die nicht erfordert, dass die Windows Sockets-DLL geladen werden muss, um auf eine Funktion zuzugreifen, die in Windows Sockets bereitgestellt wird, um eine Konvertierung von Zeichenfolgen in Ethernet-Adressen durchzuführen.

Wenn entweder UNICODE oder _UNICODE definiert ist, wird RtlEthernetAddressToString für RtlEthernetAddressToStringW, die Unicode-Version dieser Funktion, definiert. Der Zeichenfolgenparameter S und der Funktionsrückgabewert sind für den PWSTR-Datentyp definiert.

Wenn unicode und _UNICODE nicht definiert sind, wird RtlEthernetAddressToString für RtlEthernetAddressToStringA, die ANSI-Version dieser Funktion, definiert. Der Zeichenfolgenparameter S und der Funktionsrückgabewert sind für den PSTR-Datentyp definiert.

Der datentyp DL_EUI48 wird in der Mstcpip.h-Headerdatei definiert.

Hinweis

Der ip2string.h-Header definiert RtlEthernetAddressToString 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
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile ip2string.h (include Mstcpip.h, Ip2string.h)
Bibliothek ntdll.lib
DLL ntdll.dll

Weitere Informationen

RtlEthernetStringToAddress