Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
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 |