Compartir a través de


función inet_ntoa (winsock2.h)

La función inet_ntoa convierte una dirección de red de Internet (Ipv4) en una cadena ASCII en formato decimal con puntos estándar de Internet.

Sintaxis

char *WSAAPI inet_ntoa(
  in_addr in
);

Parámetros

in

TBD

Valor devuelto

Si no se produce ningún error, inet_ntoa devuelve un puntero de carácter a un búfer estático que contiene la dirección de texto en el estándar ".'' Notación. De lo contrario, devuelve NULL.

Comentarios

La función inet_ntoa toma una estructura de direcciones de Internet especificada por el parámetro in y devuelve una cadena ASCII terminada en NULL que representa la dirección en "." (punto) notación como en "192.168.16.0", un ejemplo de una dirección IPv4 en notación decimal con puntos. La cadena devuelta por inet_ntoa reside en la memoria asignada por Windows Sockets. La aplicación no debe realizar ninguna suposición sobre la forma en que se asigna la memoria. Se garantiza que la cadena devuelta solo es válida hasta que se realiza la siguiente llamada de función de Windows Sockets dentro del mismo subproceso. Por lo tanto, los datos se deben copiar antes de que se realice otra llamada a Windows Sockets.

La función WSAAddressToString se puede usar para convertir una estructura sockaddr que contiene una dirección IPv4 en una representación de cadena de una dirección IPv4 en notación decimal con puntos de Internet estándar. La ventaja de la función WSAAddressToString es que admite direcciones IPv4 e IPv6. Otra ventaja de la función WSAAddressToString es que hay versiones ASCII y Unicode de esta función.

En Windows Vista y versiones posteriores, la función RtlIpv4AddressToString se puede usar para convertir una dirección IPv4 representada como una estructura de IN_ADDR en una representación de cadena de una dirección IPv4 en notación decimal de puntos estándar de Internet. En Windows Vista y versiones posteriores, la función RtlIpv6AddressToString se puede usar para convertir una dirección IPv6 representada como una estructura de IN6_ADDR en una representación de cadena de una dirección IPv6.

Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winsock2.h (incluya Winsock2.h, Winsock.h)
Library Ws2_32.lib
Archivo DLL Ws2_32.dll

Consulte también

IN6_ADDR

InetNtop

RtlIpv4AddressToString

RtlIpv4AddressToStringEx

RtlIpv4StringToAddress

RtlIpv4StringToAddressEx

RtlIpv6AddressToString

RtlIpv6AddressToStringEx

RtlIpv6StringToAddress

RtlIpv6StringToAddressEx

SOCKADDR

WSAAddressToString

Funciones winsock

Referencia de Winsock

in_addr

inet_addr