Функция RtlIpv4AddressToStringA (ip2string.h)
Функция RtlIpv4AddressToString преобразует IPv4-адрес в строку в стандартном десятичном формате Интернета.
Синтаксис
NTSYSAPI PSTR RtlIpv4AddressToStringA(
[in] const in_addr *Addr,
[out] PSTR S
);
Параметры
[in] Addr
Адрес IPv4 в порядке байтов сети.
[out] S
Указатель на буфер, в котором хранится NULL-строковое представление IPv4-адреса. Этот буфер должен быть достаточно большим, чтобы содержать не менее 16 символов.
Возвращаемое значение
Указатель на символ NULL, вставленный в конце строкового представления IPv4-адреса. Это можно использовать вызывающим методом для легкого добавления дополнительных сведений в строку.
Замечания
Функция RtlIpv4AddressToString используется для преобразования IPv4-адреса в строковое представление IPv4-адреса в формате с точками в Интернете.
RtlIpv4AddressToString — это удобная функция, которая не требует загрузки библиотеки DLL сокетов Windows для доступа к функции, предоставленной в сокетах Windows для выполнения преобразования 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] |
| целевая платформа | Виндоус |
| заголовка | ip2string.h (include Mstcpip.h, Ip2string.h) |
| библиотеки |
ntdll.lib |
| DLL | ntdll.dll |