RtlIpv4AddressToStringA-Funktion (ip2string.h)
Die RtlIpv4AddressToString--Funktion wandelt eine IPv4-Adresse in eine Zeichenfolge im Internetstandard punktiertes Dezimalformat um.
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 lang zu halten.
Rückgabewert
Ein Zeiger auf das NULL-Zeichen, das am Ende der Zeichenfolgendarstellung der IPv4-Adresse eingefügt wurde. Dies kann vom Aufrufer verwendet werden, um problemlos weitere Informationen an die Zeichenfolge anzufügen.
Bemerkungen
Die RtlIpv4AddressToString--Funktion wird verwendet, um eine IPv4-Adresse in die Zeichenfolgendarstellung der IPv4-Adresse im Internet punktiertes Dezimalformat 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 IP-Adresse für die Zeichenfolgenkonvertierung auszuführen.
Wenn unicode oder _UNICODE definiert ist, wird RtlIpv4AddressToString- für RtlIpv4AddressToStringWdefiniert, 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 RtlIpv4AddressToString- für RtlIpv4AddressToStringAdefiniert, die ANSI-Version dieser Funktion. Der Zeichenfolgenparameter S und der Rückgabewert der Funktion werden für den PSTR-Datentyp definiert.
Die IN_ADDR Struktur wird in der Inaddr.h Headerdatei definiert.
Eine Importbibliothek, die die RtlIpv4AddressToString--Funktion enthält, ist nicht im für Windows Vista veröffentlichten Microsoft Windows Software Development Kit (SDK) enthalten. Die funktion RtlIpv4AddressToString ist in der Ntdll.lib Importbibliothek enthalten, die im Windows Driver Kit (WDK) enthalten ist. Eine Anwendung kann auch die GetModuleHandle- und GetProcAddress- Funktionen verwenden, um den Funktionszeiger aus dem Ntdll.dll abzurufen und diese Funktion aufzurufen.
Anmerkung
Der header ip2string.h 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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | ip2string.h (include Mstcpip.h, Ip2string.h) |
| Library | ntdll.lib |
| DLL- | ntdll.dll |