Compartilhar via


função inet_ntoa (winsock.h)

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

Sintaxe

char * 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, 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 em notação decimal pontilhada. 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 que contém um endereço IPv4 em uma representação de cadeia de caracteres de um endereço IPv4 na notação decimal pontilhada 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 há versões ASCII e Unicode dessa função.

No Windows Vista e posterior, 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 pontilhada padrão da Internet. No Windows Vista e posterior, 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 winsock.h (incluem Winsock2.h, Winsock.h)
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também

IN6_ADDR

InetNtop

RtlIpv4AddressToString

RtlIpv4AddressToStringEx

RtlIpv4StringToAddress

RtlIpv4StringToAddressEx

RtlIpv6AddressToString

RtlIpv6AddressToStringEx

RtlIpv6StringToAddress

RtlIpv6StringToAddressEx

SOCKADDR

WSAAddressToString

Funções Winsock

Referência de Winsock

End_inet

Inet_addr