RtlIpv4AddressToStringW-Funktion (ip2string.h)

Artikel
08/24/2023

Die RtlIpv4AddressToString-Funktion konvertiert eine IPv4-Adresse in eine Zeichenfolge im Internetstandardformat mit punktierten Dezimalstellen.

Syntax

NTSYSAPI PWSTR RtlIpv4AddressToStringW(
  [in]  const in_addr *Addr,
  [out] PWSTR         S
);

Parameter

[in] Addr

Die IPv4-Adresse in Netzwerkbytereihenfolge.

[out] S

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

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 Funktion zuzugreifen, die in Windows Sockets bereitgestellt wird, um die Konvertierung von IP-Adressen in Zeichenfolgen 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 sind 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 sind für den PSTR-Datentyp definiert.

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

Eine Importbibliothek, die die RtlIpv4AddressToString-Funktion enthält, 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 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


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