função inet_ntoa (winsock2.h)
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 |
Confira também
IN6_ADDR