функция inet_ntoa (winsock2.h)

Статья
03/09/2024

Функция inet_ntoa преобразует интернет-адрес (Ipv4) в строку ASCII в стандартном интернет-десятичном формате.

Синтаксис

char *WSAAPI inet_ntoa(
  in_addr in
);

Параметры

in

TBD

Возвращаемое значение

Если ошибка не возникает, inet_ntoa возвращает указатель символов в статический буфер, содержащий текстовый адрес в стандартном ".'' Нотации. В противном случае возвращается значение NULL.

Функция inet_ntoa принимает структуру интернет-адресов, указанную параметром in , и возвращает строку ASCII, завершающуюся null, которая представляет адрес в ". (точечная) нотация, как в "192.168.16.0", пример IPv4-адреса в десятичной нотации с точками. Строка, возвращаемая inet_ntoa , находится в памяти, выделенной сокетами Windows. Приложение не должно делать никаких предположений о способе выделения памяти. Возвращаемая строка гарантированно будет действительна только до следующего вызова функции Windows Sockets в том же потоке. Поэтому данные следует скопировать перед другим вызовом сокетов Windows.

Функцию WSAAddressToString можно использовать для преобразования структуры sockaddr, содержащей IPv4-адрес, в строковое представление IPv4-адреса в стандартной десятичной нотации Интернета. Преимущество функции WSAAddressToString заключается в том, что она поддерживает адреса IPv4 и IPv6. Еще одним преимуществом функции WSAAddressToString является то, что существуют версии ASCII и Юникод.

В Windows Vista и более поздних версиях функцию RtlIpv4AddressToString можно использовать для преобразования IPv4-адреса, представленного в виде структуры IN_ADDR , в строковое представление адреса IPv4 в стандартной десятичной нотации Интернета с точками. В Windows Vista и более поздних версиях функцию RtlIpv6AddressToString можно использовать для преобразования IPv6-адреса, представленного в виде структуры IN6_ADDR , в строковое представление IPv6-адреса.

Windows Phone 8. Эта функция поддерживается для приложений Магазина Windows Phone на Windows Phone 8 и более поздних версиях.

Windows 8.1 и Windows Server 2012 R2. Эта функция поддерживается для приложений Магазина Windows на Windows 8.1, Windows Server 2012 R2 и более поздних версиях.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1, Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	winsock2.h (включая Winsock2.h, Winsock.h)
Библиотека	Ws2_32.lib
DLL	Ws2_32.dll