Функция NPSearchDialog (npapi.h)

Позволяет поставщикам сетей предоставлять собственную форму просмотра и поиска, помимо иерархического представления, представленного в диалоговом окне Подключение . Если поставщик сети поддерживает эту функцию, в диалоговом окне Подключение будет включена кнопка Поиск , если выбранный элемент принадлежит этому поставщику. Если пользователь нажимает кнопку Поиск , диалоговое окно Подключение вызывает NPSearchDialog для обработки запроса пользователя.

Синтаксис

DWORD NPSearchDialog(
  [in]  HWND           hwndParent,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPVOID         lpBuffer,
  [out] DWORD          cbBuffer,
  [in]  LPDWORD        lpnFlags
);

Параметры

[in] hwndParent

Дескриптор окна, используемого в качестве родительского окна диалогового окна.

[in] lpNetResource

Указатель на выбранный элемент в диалоговом окне Сетевой Connections. Поставщик может игнорировать это поле.

[out] lpBuffer

Указатель на буфер, который получит результат поиска.

[out] cbBuffer

DWORD , указывающий размер переданного буфера.

[in] lpnFlags

Указатель на DWORD флагов, которые поставщик может задать для принудительного выполнения определенных действий после закрытия диалогового окна. Единственный поддерживаемый флаг — WNSRCH_REFRESH_FIRST_LEVEL, который заставляет MPR свернуть, а затем развернуть и обновить первый уровень ниже этого поставщика после закрытия диалогового окна.

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

Если функция выполнена успешно и пользователь нажал кнопку ОК, NPSearchDialog должен вернуть WN_SUCCESS. В противном случае он должен вернуть значение ошибки, которое может быть одним из следующих. Все остальные ошибки должны обрабатываться или сообщаться непосредственно в диалоговом окне поставщика.

Комментарии

Если поставщик не поддерживает перечисление, действие, связанное с двойным щелчком записи поставщика, будет вызывать его диалоговое окно Поиск .

Требования