inet_ntoa, fonction (winsock2.h)

Article
03/04/2024

La fonction inet_ntoa convertit une adresse réseau Internet (Ipv4) en chaîne ASCII au format Internet standard décimal en pointillés.

Syntaxe

char *WSAAPI inet_ntoa(
  in_addr in
);

Paramètres

in

TBD

Valeur retournée

Si aucune erreur ne se produit, inet_ntoa retourne un pointeur de caractères vers une mémoire tampon statique contenant l’adresse de texte dans la norme .'' notation. Sinon, elle retourne NULL.

Remarques

La fonction inet_ntoa prend une structure d’adresse Internet spécifiée par le paramètre in et retourne une chaîne ASCII terminée par NULL qui représente l’adresse dans « ». notation (point) comme dans « 192.168.16.0 », un exemple d’adresse IPv4 en notation décimale en pointillés. La chaîne retournée par inet_ntoa réside dans la mémoire allouée par les sockets Windows. L’application ne doit pas faire d’hypothèses sur la façon dont la mémoire est allouée. La chaîne retournée est garantie comme valide uniquement jusqu’à ce que l’appel de fonction Windows Sockets suivant soit effectué dans le même thread. Par conséquent, les données doivent être copiées avant qu’un autre appel Windows Sockets ne soit effectué.

La fonction WSAAddressToString peut être utilisée pour convertir une structure sockaddr contenant une adresse IPv4 en une représentation sous forme de chaîne d’une adresse IPv4 en notation décimale en pointillés standard Internet. L’avantage de la fonction WSAAddressToString est qu’elle prend en charge les adresses IPv4 et IPv6. Un autre avantage de la fonction WSAAddressToString est qu’il existe des versions ASCII et Unicode de cette fonction.

Sur Windows Vista et versions ultérieures, la fonction RtlIpv4AddressToString peut être utilisée pour convertir une adresse IPv4 représentée sous la forme d’une structure IN_ADDR en une représentation sous forme de chaîne d’une adresse IPv4 en notation décimale en pointillés standard Sur Internet. Sur Windows Vista et versions ultérieures, la fonction RtlIpv6AddressToString peut être utilisée pour convertir une adresse IPv6 représentée sous la forme d’une structure IN6_ADDR en une représentation sous forme de chaîne d’une adresse IPv6.

Windows Phone 8 : cette fonction est prise en charge pour les applications Windows Phone Store sur Windows Phone 8 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winsock2.h (inclure Winsock2.h, Winsock.h)
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll