funzione inet_ntoa (winsock2.h)

La funzione inet_ntoa converte un indirizzo di rete Internet (Ipv4) in una stringa ASCII in formato decimale standard di Internet.

Sintassi

char *WSAAPI inet_ntoa(
  in_addr in
);

Parametri

in

TBD

Valore restituito

Se non si verifica alcun errore, inet_ntoa restituisce un puntatore di caratteri a un buffer statico contenente l'indirizzo di testo nello standard ".'' Notazione. In caso contrario, restituisce NULL.

Commenti

La funzione inet_ntoa accetta una struttura di indirizzi Internet specificata dal parametro in e restituisce una stringa ASCII con terminazione NULL che rappresenta l'indirizzo in "." (punto) notazione come nella notazione "192.168.16.0", un esempio di indirizzo IPv4 nella notazione decimale tratteggiata. La stringa restituita da inet_ntoa risiede in memoria allocata da Windows Sockets. L'applicazione non deve fare ipotesi sul modo in cui viene allocata la memoria. La stringa restituita è garantita che sia valida solo fino a quando non viene eseguita la chiamata alla funzione Windows Sockets successiva all'interno dello stesso thread. Pertanto, i dati devono essere copiati prima che venga eseguita un'altra chiamata a Windows Sockets.

La funzione WSAaddressToString può essere usata per convertire una struttura sockaddr contenente un indirizzo IPv4 in una rappresentazione stringa di un indirizzo IPv4 in notazione decimale standard di Internet. Il vantaggio della funzione WSAAddressToString è che supporta sia indirizzi IPv4 che IPv6. Un altro vantaggio della funzione WSAAddressToString è che esistono sia versioni ASCII che Unicode di questa funzione.

In Windows Vista e versioni successive, la funzione RtlIpv4AddressToString può essere usata per convertire un indirizzo IPv4 rappresentato come struttura IN_ADDR in una rappresentazione stringa di un indirizzo IPv4 nella notazione decimale standard di Internet. In Windows Vista e versioni successive, la funzione RtlIpv6AddressToString può essere usata per convertire un indirizzo IPv6 rappresentato come struttura IN6_ADDR in una rappresentazione stringa di un indirizzo IPv6.

Windows Phone 8: questa funzione è supportata per le app Windows Phone Store in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1, Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione winsock2.h (includono Winsock2.h, Winsock.h)
Libreria Ws2_32.lib
DLL Ws2_32.dll

Vedi anche

IN6_ADDR

InetNtop

RtlIpv4AddressToString

RtlIpv4AddressToStringEx

RtlIpv4StringToAddress

RtlIpv4StringToAddressEx

RtlIpv6AddressToString

RtlIpv6AddressToStringEx

RtlIpv6StringToAddress

RtlIpv6StringToAddressEx

SOCKADDR

WSAAddressToString

Funzioni Winsock

Informazioni di riferimento su Winsock

in_addr

inet_addr