função de retorno de chamada PWLX_DIALOG_BOX (winwlx.h)
[A função WlxDialogBox não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]
Chamado pela GINA para criar uma caixa de diálogo modal de um modelo de caixa de diálogo.
Sintaxe
PWLX_DIALOG_BOX PwlxDialogBox;
int PwlxDialogBox(
[in] HANDLE hWlx,
[in] HANDLE hInst,
[in] LPWSTR lpszTemplate,
[in] HWND hwndOwner,
[in] DLGPROC dlgprc
)
{...}
Parâmetros
[in] hWlx
Especifica o identificador Winlogon passado para GINA na chamada WlxInitialize .
[in] hInst
Especifica uma instância do módulo cujo arquivo executável contém o modelo da caixa de diálogo.
[in] lpszTemplate
Especifica o modelo da caixa de diálogo. Esse parâmetro é o endereço de uma cadeia de caracteres terminada em nulo que especifica o nome do modelo da caixa de diálogo ou um valor inteiro que especifica o identificador de recurso do modelo da caixa de diálogo. Se o parâmetro especificar um identificador de recurso, a palavra de alta ordem deverá ser zero e a palavra de baixa ordem deverá conter o identificador. Você pode usar a macro MAKEINTRESOURCE para criar esse valor.
[in] hwndOwner
Especifica a janela que possui a caixa de diálogo.
[in] dlgprc
Aponta para o procedimento da caixa de diálogo. Para obter mais informações sobre o procedimento da caixa de diálogo, consulte a função de retorno de chamada DialogProc .
Retornar valor
Se a função WlxDialogBox for bem-sucedida, o valor retornado será o parâmetro nResult fornecido na chamada para a função EndDialog usada para encerrar a caixa de diálogo. A tabela a seguir lista alguns valores de retorno de sucesso possíveis.
Código de retorno | Descrição |
---|---|
|
A entrada atingiu o tempo limite. |
|
Ocorreu um evento SAS ( sequência de atenção segura ). |
|
O tempo limite de economia de tela atingiu o tempo limite. |
|
O usuário fez logoff. |
Se a função falhar, o valor retornado será –1.
Comentários
GINA deve usar a função Winlogon WlxDialogBox , não a macro Caixa de Diálogo do Windows. O WlxDialogBox duplica a macro Caixa de Diálogo do Windows e também permite que o Winlogon encerre a caixa de diálogo. Para obter mais informações, consulte Caixa de Diálogo.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | winwlx.h |