функция обратного вызова PWLX_DIALOG_BOX (winwlx.h)
[Функция WlxDialogBox больше не доступна для использования в Windows Server 2008 и Windows Vista.]
Вызывается GINA для создания модального диалогового окна на основе шаблона диалогового окна.
Синтаксис
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 , используемой для завершения диалогового окна. В следующей таблице перечислены некоторые возможные возвращаемые значения успешного выполнения.
| Код возврата | Описание |
|---|---|
|
Истекло время ожидания ввода. |
|
Произошло событие безопасной последовательности внимания (SAS). |
|
Истекло время ожидания заставки. |
|
Пользователь выошел из системы. |
Если функция завершается сбоем, возвращается значение –1.
Комментарии
GINA должна использовать функцию Winlogon WlxDialogBox , а не макрос Windows DialogBox . WlxDialogBox дублирует макрос Windows DialogBox , а также позволяет Winlogon завершить диалоговое окно. Дополнительные сведения см. в разделе DialogBox.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winwlx.h |