fonction inet_ntoa (winsock.h)
La fonction inet_ntoa convertit une adresse réseau Internet (Ipv4) en chaîne ASCII au format décimal en pointillés standard.
Syntaxe
char * 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. Dans le cas contraire, elle retourne LA VALEUR 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 « ». (point) notation comme dans « 192.168.16.0 », 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 le prochain appel de fonction Sockets Windows soit effectué dans le même thread. Par conséquent, les données doivent être copiées avant qu’un autre appel de sockets Windows 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. 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 Internet. Sur Windows Vista et versions ultérieures, la fonction RtlIpv6AddressToString peut être utilisée pour convertir une adresse IPv6 représentée en tant que 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 du Store Windows Phone 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 | winsock.h (inclure Winsock2.h, Winsock.h) |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |
Voir aussi
IN6_ADDR