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.
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 |
|---|---|
|
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
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 |