функция обратного вызова PWLX_DIALOG_BOX (winwlx.h)

Статья
03/04/2024

[Функция WlxDialogBox больше не доступна для использования в Windows Server 2008 и Windows Vista.]

Вызывается GINA для создания модального диалогового окна на основе шаблона диалогового окна.

Примечание Библиотеки DLL GINA игнорируются в Windows Vista.

Синтаксис

PWLX_DIALOG_BOX PwlxDialogBox;

int PwlxDialogBox(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPWSTR lpszTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc
)
{...}

Параметры

[in] hWlx

Указывает дескриптор Winlogon, переданный в GINA в вызове WlxInitialize .

[in] hInst

Указывает экземпляр модуля, исполняемый файл которого содержит шаблон диалогового окна.

[in] lpszTemplate

Указывает шаблон диалогового окна. Этот параметр является либо адресом строки символов, заканчивающейся null, которая указывает имя шаблона диалогового окна, либо целочисленным значением, указывающим идентификатор ресурса шаблона диалогового окна. Если параметр задает идентификатор ресурса, его высокоупорядоченное слово должно быть равно нулю, а слово нижнего порядка должно содержать идентификатор. Для создания этого значения можно использовать макрос MAKEINTRESOURCE .

[in] hwndOwner

Указывает окно, которому принадлежит диалоговое окно.

[in] dlgprc

Указывает на процедуру диалогового окна. Дополнительные сведения о процедуре диалогового окна см. в разделе Функция обратного вызова DialogProc .

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

Если функция WlxDialogBox завершается успешно, возвращаемым значением будет параметр nResult , заданный в вызове функции EndDialog , используемой для завершения диалогового окна. В следующей таблице перечислены некоторые возможные возвращаемые значения успешного выполнения.

Код возврата	Описание
WLX_DLG_INPUT_TIMEOUT	Истекло время ожидания ввода.
WLX_DLG_SAS	Произошло событие безопасной последовательности внимания (SAS).
WLX_DLG_SCREEN_SAVER_TIMEOUT	Истекло время ожидания заставки.
WLX_DLG_USER_LOGOFF	Пользователь выошел из системы.

Если функция завершается сбоем, возвращается значение –1.

GINA должна использовать функцию Winlogon WlxDialogBox , а не макрос Windows DialogBox . WlxDialogBox дублирует макрос Windows DialogBox , а также позволяет Winlogon завершить диалоговое окно. Дополнительные сведения см. в разделе DialogBox.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winwlx.h

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