inet_ntoa-Funktion (winsock2.h)

Artikel
03/09/2024

Die inet_ntoa-Funktion konvertiert eine (Ipv4)-Internetnetzwerkadresse in eine ASCII-Zeichenfolge im Internetstandard-Dezimalformat.

Syntax

char *WSAAPI inet_ntoa(
  in_addr in
);

Parameter

in

TBD

Rückgabewert

Wenn kein Fehler auftritt, gibt inet_ntoa einen Zeichenzeiger auf einen statischen Puffer zurück, der die Textadresse im Standard ""enthält. Notation. Andernfalls wird NULL zurückgegeben.

Hinweise

Die inet_ntoa-Funktion übernimmt eine Internetadressenstruktur, die durch den -Parameter in angegeben wird, und gibt eine NULL-beendete ASCII-Zeichenfolge zurück, die die Adresse in "" darstellt. (Punkt)-Notation wie in "192.168.16.0", ein Beispiel für eine IPv4-Adresse in gepunkteter Dezimalschreibweise. Die von inet_ntoa zurückgegebene Zeichenfolge befindet sich im Arbeitsspeicher, der von Windows Sockets zugewiesen wird. Die Anwendung sollte keine Annahmen über die Art und Weise machen, in der der Arbeitsspeicher zugewiesen wird. Die zurückgegebene Zeichenfolge ist garantiert nur gültig, bis der nächste Windows Sockets-Funktionsaufruf innerhalb desselben Threads erfolgt. Daher sollten die Daten kopiert werden, bevor ein weiterer Windows Sockets-Aufruf erfolgt.

Die WSAAddressToString-Funktion kann verwendet werden, um eine Sockaddr-Struktur , die eine IPv4-Adresse enthält, in eine Zeichenfolgendarstellung einer IPv4-Adresse in gepunkteter Dezimalschreibweise im Internetstandard zu konvertieren. Der Vorteil der WSAAddressToString-Funktion besteht darin, dass sie sowohl IPv4- als auch IPv6-Adressen unterstützt. Ein weiterer Vorteil der WSAAddressToString-Funktion ist, dass es sowohl ASCII- als auch Unicode-Versionen dieser Funktion gibt.

Unter Windows Vista und höher kann die RtlIpv4AddressToString-Funktion verwendet werden, um eine als IN_ADDR Struktur dargestellte IPv4-Adresse in eine Zeichenfolgendarstellung einer IPv4-Adresse in gepunkteter Dezimalschreibweise im Internetstandard zu konvertieren. Unter Windows Vista und höher kann die RtlIpv6AddressToString-Funktion verwendet werden, um eine als IN6_ADDR Struktur dargestellte IPv6-Adresse in eine Zeichenfolgendarstellung einer IPv6-Adresse zu konvertieren.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps auf Windows Phone 8 und höher unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winsock2.h (einschließlich Winsock2.h, Winsock.h)
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll