Compartilhar via


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

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

Chamado por GINA para inicializar controles de caixa de diálogo e, em seguida, criar uma caixa de diálogo modal a partir de um recurso de modelo de caixa de diálogo.

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

Sintaxe

PWLX_DIALOG_BOX_PARAM PwlxDialogBoxParam;

int PwlxDialogBoxParam(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPWSTR lpszTemplate,
  [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 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 saber mais sobre o procedimento da caixa de diálogo, confira DialogProc.

[in] dwInitParam

Especifica o valor a ser passado para a caixa de diálogo no parâmetro lParam da mensagem WM_INITDIALOG .

Retornar valor

Se a função WlxDialogBoxParam for bem-sucedida, o valor retornado será o valor do 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

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

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

Dialogboxparam

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize