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

Статья
08/28/2023

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

Вызывается GINA для инициализации элементов управления диалоговых окон, а затем создания модального диалогового окна из ресурса шаблона диалогового окна.

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

Синтаксис

PWLX_DIALOG_BOX_PARAM PwlxDialogBoxParam;

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

Параметры

[in] hWlx

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

[in] hInst

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

[in] lpszTemplate

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

[in] hwndOwner

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

[in] dlgprc

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

[in] dwInitParam

Задает значение, передаваемое в диалоговое окно в параметре lParamсообщения WM_INITDIALOG .

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

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

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

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

Требования

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

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