Функция RtlIpv4AddressToStringW (ip2string.h)
Функция RtlIpv4AddressToString преобразует IPv4-адрес в строку в стандартном интернет-десятичном формате.
Синтаксис
NTSYSAPI PWSTR RtlIpv4AddressToStringW(
[in] const in_addr *Addr,
[out] PWSTR S
);
Параметры
[in] Addr
IPv4-адрес в порядке байтов сети.
[out] S
Указатель на буфер, в котором хранится строковое представление IPv4-адреса, завершающееся null. Этот буфер должен быть достаточно большим, чтобы вместить не менее 16 символов.
Возвращаемое значение
Указатель на символ NULL, вставленный в конце строкового представления IPv4-адреса. Его может использовать вызывающий объект, чтобы легко добавлять дополнительные сведения в строку.
Комментарии
Функция RtlIpv4AddressToString используется для преобразования IPv4-адреса в строковое представление IPv4-адреса в интернет-пунктирном десятичном формате.
RtlIpv4AddressToString — это удобная функция, которая не требует загрузки библиотеки DLL windows для доступа к функции, предоставленной в Windows Sockets, для выполнения преобразования IP-адреса в строку.
Если определен юникод или _UNICODE, RtlIpv4AddressToString определяется как RtlIpv4AddressToStringW, версия Юникода этой функции. Строковый параметр S и возвращаемое значение функции определяются для типа данных PWSTR.
Если и ЮНИКОД, и _UNICODE не определены, RtlIpv4AddressToString определяется как RtlIpv4AddressToStringA, версия ANSI этой функции. Строковый параметр S и возвращаемое значение функции определяются для типа данных PSTR.
Структура IN_ADDR определяется в файле заголовка Inaddr.h .
Библиотека импорта, содержащая функцию RtlIpv4AddressToString , не включена в пакет SDK microsoft Windows, выпущенный для Windows Vista. Функция RtlIpv4AddressToString включена в библиотеку импорта Ntdll.lib , включенную в комплект драйверов Windows (WDK). Приложение также может использовать функции GetModuleHandle и GetProcAddress для получения указателя функции из Ntdll.dll и вызова этой функции.
Примечание
Заголовок ip2string.h определяет RtlIpv4AddressToString в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | ip2string.h (включая Mstcpip.h, Ip2string.h) |
| Библиотека | ntdll.lib |
| DLL | ntdll.dll |