RtlIpv4AddressToStringA-Funktion (ip2string.h)

Artikel
08/24/2023

Die RtlIpv4AddressToString-Funktion konvertiert eine IPv4-Adresse in eine Zeichenfolge im Internetstandard mit punktierten Dezimalzahlen.

Syntax

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

Parameter

[in] Addr

Die IPv4-Adresse in Netzwerkbytereihenfolge.

[out] S

Ein Zeiger auf einen Puffer, in dem die NULL-beendete Zeichenfolgendarstellung der IPv4-Adresse gespeichert werden soll. Dieser Puffer sollte groß genug sein, um mindestens 16 Zeichen aufzunehmen.

Rückgabewert

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

Hinweise

Die RtlIpv4AddressToString-Funktion wird verwendet, um eine IPv4-Adresse in die Zeichenfolgendarstellung der IPv4-Adresse im Internet dotted-decimal-Format zu konvertieren.

RtlIpv4AddressToString ist eine Komfortfunktion, die nicht erfordert, dass die Windows Sockets-DLL geladen werden muss, um auf eine in Windows Sockets bereitgestellte Funktion zuzugreifen, um eine IP-Adress-in-Zeichenfolgenkonvertierung durchzuführen.

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

Wenn sowohl UNICODE als auch _UNICODE nicht definiert sind, wird RtlIpv4AddressToString für "RtlIpv4AddressToStringA", die ANSI-Version dieser Funktion, definiert. Der Zeichenfolgenparameter S und der Funktionsrückgabewert werden für den PSTR-Datentyp definiert.

Die IN_ADDR-Struktur ist in der Headerdatei Inaddr.h definiert.

Eine Importbibliothek mit der Funktion RtlIpv4AddressToString ist nicht im Microsoft Windows Software Development Kit (SDK) enthalten, das für Windows Vista veröffentlicht wurde. Die RtlIpv4AddressToString-Funktion ist in der Ntdll.lib-Importbibliothek enthalten, die im Windows Driver Kit (WDK) enthalten ist. Eine Anwendung kann auch die Funktionen GetModuleHandle und GetProcAddress verwenden, um den Funktionszeiger aus dem Ntdll.dll abzurufen und diese Funktion aufzurufen.

Hinweis

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	ip2string.h (include Mstcpip.h, Ip2string.h)
Bibliothek	ntdll.lib
DLL	ntdll.dll