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.

Nota As DLLs GINA são ignoradas no Windows Vista.
 

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
WLX_DLG_INPUT_TIMEOUT
A entrada atingiu o tempo limite.
WLX_DLG_SAS
Ocorreu um evento SAS ( sequência de atenção segura ).
WLX_DLG_SCREEN_SAVER_TIMEOUT
O tempo limite de economia de tela atingiu o tempo limite.
WLX_DLG_USER_LOGOFF
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

Confira também

Dialogbox

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize