Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function converts an ( Ipv4) Internet network address into a string in Internet standard dotted format.

Syntax 

char FAR* inet_ntoa(
  struct in_addr 
in
);

Parameters

in

[in] Structure that represents an Internet host address.

Return Value

If no error occurs, this function returns a character pointer to a static buffer containing the text address in standard "." notation. If an error occurs, it returns NULL.

Remarks

This function takes an Internet address structure specified by the inparameter and returns an ASCII string representing the address in "." (dot) notation as in "a.b.c.d". The string returned by this function resides in memory that is allocated by Windows Sockets. The application should not make any assumptions about the way in which the memory is allocated. The data is guaranteed to be valid until the next Windows Sockets function call within the same thread, but no longer. Therefore, the data should be copied before another Windows Sockets call is made.

Requirements

Header winsock2.h
Library Ws2.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

inet_addr