função inet_ntoa (winsock2.h)

Artigo
08/27/2023

A função inet_ntoa converte um endereço de rede da Internet (Ipv4) em uma cadeia de caracteres ASCII no formato dotted-decimal padrão da Internet.

Sintaxe

char *WSAAPI inet_ntoa(
  in_addr in
);

Parâmetros

in

TBD

Retornar valor

Se nenhum erro ocorrer, inet_ntoa retornará um ponteiro de caractere para um buffer estático que contém o endereço de texto no padrão ".'' Notação. Caso contrário, ele retornará NULL.

Comentários

A função inet_ntoa usa uma estrutura de endereços da Internet especificada pelo parâmetro in e retorna uma cadeia de caracteres ASCII terminada em NULL que representa o endereço em "". (ponto) notação como em "192.168.16.0", um exemplo de um endereço IPv4 na notação dotted-decimal. A cadeia de caracteres retornada por inet_ntoa reside na memória alocada pelo Windows Sockets. O aplicativo não deve fazer nenhuma suposição sobre a maneira como a memória é alocada. A cadeia de caracteres retornada tem a garantia de ser válida somente até que a próxima chamada de função do Windows Sockets seja feita dentro do mesmo thread. Portanto, os dados devem ser copiados antes que outra chamada do Windows Sockets seja feita.

A função WSAAddressToString pode ser usada para converter uma estrutura sockaddr contendo um endereço IPv4 em uma representação de cadeia de caracteres de um endereço IPv4 na notação decimal dotted-decimal padrão da Internet. A vantagem da função WSAAddressToString é que ela dá suporte a endereços IPv4 e IPv6. Outra vantagem da função WSAAddressToString é que existem versões ASCII e Unicode dessa função.

No Windows Vista e posteriores, a função RtlIpv4AddressToString pode ser usada para converter um endereço IPv4 representado como uma estrutura IN_ADDR em uma representação de cadeia de caracteres de um endereço IPv4 na notação decimal dotted-decimal padrão da Internet. No Windows Vista e posteriores, a função RtlIpv6AddressToString pode ser usada para converter um endereço IPv6 representado como uma estrutura IN6_ADDR em uma representação de cadeia de caracteres de um endereço IPv6.

Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1, Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winsock2.h (inclua Winsock2.h, Winsock.h)
Biblioteca	Ws2_32.lib
DLL	Ws2_32.dll