RtlEthernetAddressToStringA-Funktion (ip2string.h)
Die RtlEthernetAddressToString--Funktion wandelt eine binäre Ethernet-Adresse in eine Zeichenfolgendarstellung der Ethernet-MAC-Adresse um.
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 (Von links nach rechts sortierte Bytes).
[out] S
Ein Zeiger auf einen Puffer, in dem die NULL--beendete Zeichenfolgendarstellung der Ethernet-Adresse gespeichert werden soll. Dieser Puffer sollte groß genug sein, um mindestens 18 Zeichen lang zu halten.
Rückgabewert
Ein Zeiger auf das NULL-Zeichen, das am Ende der Zeichenfolgendarstellung der Ethernet MAC-Adresse eingefügt wurde. Dies kann vom Aufrufer verwendet werden, um problemlos weitere Informationen an die Zeichenfolge anzufügen.
Bemerkungen
Die funktion RtlEthernetAddressToString wird verwendet, um eine binäre Ethernet-Adresse in die Zeichenfolgendarstellung der Ethernet-Adresse im Ethernet-EUI-48-Datenlink-Layer-Adressformat (auch bekannt als MAC-Adresse) zu konvertieren. Die Zeichenfolge stellt eine numerische Ethernet-Adresse dar, die in der Nicht-DIX-Standardnotation "-'' angegeben ist.
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 Gedankenstriche getrennt sind (z. B. F4-CE-46-2D-90-8C).
RtlEthernetAddressToString 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 zur Ethernet-Adresskonvertierung auszuführen.
Wenn unicode oder _UNICODE definiert ist, wird RtlEthernetAddressToString für RtlEthernetAddressToStringWdefiniert, die Unicode-Version dieser Funktion. Der Zeichenfolgenparameter S und der Rückgabewert der Funktion werden für den PWSTR Datentyp definiert.
Wenn unicode und _UNICODE nicht definiert sind, wird RtlEthernetAddressToString für RtlEthernetAddressToStringAdefiniert, die ANSI-Version dieser Funktion. Der Zeichenfolgenparameter S und der Rückgabewert der Funktion werden für den datentyp PSTR- definiert.
Der DL_EUI48 Datentyp wird in der Mstcpip.h Headerdatei definiert.
Anmerkung
Der header ip2string.h 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 |
|---|---|
| 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 |