Поделиться через

NCM_GETADDRESS сообщение

  • Статья

Указывает, соответствует ли сетевой адрес указанному типу и формату.

NCM_GETADDRESS

    wParam = (WPARAM) (PNC_ADDRESS) pv;

    lParam = 0;

Параметры

wParam

Должен равняться нулю.

pv [in, out]

Указатель на NC_ADDRESS структуру для получения сведений о сетевом адресе в проанализированной форме, если проверяются формат адреса и тип в элементе управления, заданном параметром *hwnd*. Вызывающее приложение отвечает за выделение памяти для этой структуры.

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

Возвращает одно из следующих значений типа HRESULT.

Код возврата Описание
E_INVALIDARG
 Вызывающему приложению не удалось выделить NC_ADDRESS структуру.
ERROR_INSUFFICIENT_BUFFER
 Буфер вывода слишком мал для хранения проанализированного сетевого адреса.
ERROR_INVALID_PARAMETER
 Строка сетевого адреса не указана ни одного типа.
ERROR_SUCCESS
 Операция выполнена успешно.
S_FALSE
 В элементе управления сетевыми адресами для проверки нет адреса.

 

Комментарии

Используйте сообщение NCM_GETADDRESS для проверки сетевого адреса в элементе управления сетевыми адресами на соответствие предустановленной маске типа сетевого адреса. Для создания экземпляра используйте класс msctls_netaddress, определенный в Shellapi.h. Вызовите InitNetworkAddressControl во время выполнения перед отправкой этого сообщения. При этом инициализируется библиотека общих элементов управления, содержащая элемент управления сетевыми адресами.

Это сообщение получает строку сетевого адреса из элемента управления сетевым адресом, анализирует строку и проверяет, соответствует ли строка маске типа сетевого адреса. Если строка соответствует маске, сообщение возвращает S_OK и строку в проанализированной форме вызывающему приложению (включая номер порта, длину префикса и другие сведения об адресе), используя структуру NC_ADDRESS , на которую указывает pv. Это сообщение возвращает E_INVALIDARG, если вызывающему приложению не удается выделить структуру, на которую указывает pv.

Анализируются представления IP-адресов версий 4 и 6 (версии 4/6) для служб и сетей, а также именованных интернет-адресов и служб, использующих формат DNS. Если строка сетевого адреса представляет именованное имя узла (DNS) или службу, значение, возвращаемое в элементе PrefixLengthNC_ADDRESS , равно нулю.

Задайте маску типа сетевого адреса с помощью сообщения NCM_SETALLOWTYPE перед отправкой макроса NCM_GETADDRESS .

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]
Заголовок
Shellapi.h

См. также раздел

NCM_GETALLOWTYPE

NetAddr_GetAddress