Функция RtlIpv4AddressToStringA (ip2string.h)

Статья
08/24/2023

Функция RtlIpv4AddressToString преобразует IPv4-адрес в строку в стандартном интернет-точечном формате.

Синтаксис

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

Параметры

[in] Addr

IPv4-адрес в сетевом порядке байтов.

[out] S

Указатель на буфер, в котором хранится строковое представление IPv4-адреса, завершающееся значением NULL. Этот буфер должен быть достаточно большим и содержать не менее 16 символов.

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

Указатель на символ NULL, вставленный в конце строкового представления IPv4-адреса. Вызывающий объект может использовать его для добавления дополнительных сведений в строку.

RtlIpv4AddressToString — это удобная функция, которая не требует загрузки библиотеки DLL сокетов Windows для доступа к функции, предоставленной в сокетах Windows, для выполнения преобразования IP-адресов в строки.

При определении юникода или _UNICODE RtlIpv4AddressToString определяется как RtlIpv4AddressToStringW, версия этой функции в Юникоде. Строковый параметр S и возвращаемое значение функции определяются для типа данных PWSTR.

Если юникод и _UNICODE не определены, RtlIpv4AddressToString определяется в RtlIpv4AddressToStringA, версии ANSI этой функции. Строковый параметр S и возвращаемое значение функции определяются для типа данных PSTR.

Структура IN_ADDR определяется в файле заголовка Inaddr.h .

Библиотека импорта, содержащая функцию RtlIpv4AddressToString , не входит в пакет средств разработки программного обеспечения Microsoft Windows (SDK), выпущенный для Windows Vista. Функция RtlIpv4AddressToString входит в библиотеку импорта Ntdll.lib , включенную в комплект драйверов Windows (WDK). Приложение также может использовать функции GetModuleHandle и GetProcAddress для получения указателя функции из Ntdll.dll и вызова этой функции.

Примечание

Заголовок ip2string.h определяет RtlIpv4AddressToString как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	ip2string.h (включая Mstcpip.h, Ip2string.h)
Библиотека	ntdll.lib
DLL	ntdll.dll