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

Artigo
08/28/2023

[A função WlxDialogBoxIndirectParam não está mais disponível para uso desde o Windows Server 2008 e o Windows Vista.]

Chamado por GINA para inicializar controles de caixa de diálogo e, em seguida, criar uma caixa de diálogo modal 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_PARAM PwlxDialogBoxIndirectParam;

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

Parâmetros

[in] hWlx

Especifica o identificador winlogon passado para GINA na chamada WlxInitialize .

[in] hInst

Especifica 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

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 descrição da função de retorno de chamada DialogProc no SDK da Plataforma.

[in] dwInitParam

Especifica o valor usado para inicializar o controle da caixa de diálogo. Esse valor é passado para a caixa de diálogo no parâmetro lParam da mensagem WM_INITDIALOG .

Valor retornado

Se a função for bem-sucedida, a função retornará o parâmetro nResult dado 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 de SAS ( sequência de atenção segura ).
WLX_DLG_SCREEN_SAVER_TIMEOUT	A economia de tela atingiu o tempo limite.
WLX_DLG_USER_LOGOFF	O usuário fez logon.

Se a função falhar, o valor retornado será –1.

Comentários

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

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