макрос NetAddr_GetAddress (shellapi.h)
Указывает, соответствует ли сетевой адрес указанному типу и формату.
Синтаксис
void NetAddr_GetAddress(
hwnd,
[in, out] pv
);
Параметры
hwnd
Дескриптор элемента управления сетевыми адресами, который содержит адрес для проверки.
[in, out] pv
Указатель на структуру NC_ADDRESS для получения сведений о сетевом адресе в проанализированном виде, если проверяются формат и тип адреса в элементе управления, заданном hwnd . Вызывающее приложение отвечает за выделение памяти для этой структуры.
Возвращаемое значение
None
Remarks
Используйте макрос NetAddr_GetAddress для проверки сетевого адреса в элементе управления сетевыми адресами на соответствие предустановленной маске типа сетевого адреса. Для создания экземпляра используйте класс msctls_netaddress , определенный в Shellapi.h. Вызовите Метод InitNetworkAddressControl во время выполнения перед вызовом этого макроса. При этом инициализируется библиотека общих элементов управления, содержащая элемент управления "Сетевой адрес".
Этот макрос получает строку сетевого адреса из элемента управления сетевыми адресами, анализирует строку и проверяет, соответствует ли строка маске типа сетевого адреса. Если строка соответствует маске, функция возвращает S_OK и возвращает строку в проанализированном виде вызывающей приложению (включая номер порта, длину префикса и другие сведения об адресе), используя структуру NC_ADDRESS , на которую указывает pv. Этот макрос возвращает E_INVALIDARG, если вызывающей приложению не удается выделить структуру, на которую указывает pv.
Анализируются представления IP-адресов версий 4 и 6 (версии 4 и 6) для служб и сетей, а также именованные ip-адреса и службы, использующие формат DNS. Если строка сетевого адреса представляет именованное имя узла (DNS) или службу, значение, возвращаемое в элементе PrefixLengthNC_ADDRESS , равно нулю.
Задайте маску типа сетевого адреса с помощью макроса NetAddr_SetAllowType перед вызовом макроса NetAddr_GetAddress .
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shellapi.h |