função de retorno de chamada PWLX_DIALOG_BOX_INDIRECT (winwlx.h)

Artigo
08/28/2023

[A função WlxDialogBoxIndirect não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

Chamado por GINA para criar uma caixa de diálogo modal a partir de um modelo de caixa de diálogo na memória.

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

Sintaxe

PWLX_DIALOG_BOX_INDIRECT PwlxDialogBoxIndirect;

int PwlxDialogBoxIndirect(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPCDLGTEMPLATE hDialogTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc
)
{...}

Parâmetros

[in] hWlx

Identificador winlogon fornecido ao GINA na chamada WlxInitialize .

[in] hInst

Identifica a instância do módulo que cria a caixa de diálogo.

[in] hDialogTemplate

Especifica o endereço de um objeto de memória global que contém um modelo de caixa de diálogo usado para criar a caixa de diálogo. O modelo está na forma de uma estrutura DLGTEMPLATE seguida por uma ou mais estruturas DLGITEMTEMPLATE . Para obter uma descrição completa dessas estruturas, consulte o SDK da plataforma.

[in] hwndOwner

Identifica a janela que possui a caixa de diálogo.

[in] dlgprc

Aponta para o procedimento da caixa de diálogo. Para saber mais sobre o procedimento da caixa de diálogo, confira DialogProc.

Valor retornado

Se a função WlxDialogBoxIndirect 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

WlxDialogBoxIndirect duplica a macro DialogBoxIndirect do Windows e também permite que o Winlogon encerre a caixa de diálogo. Para obter mais informações, consulte DialogBoxIndirect.

Requisitos


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