função de retorno de chamada PWLX_MESSAGE_BOX (winwlx.h)
[A função WlxMessageBox não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]
A função WlxMessageBox é chamada por GINA para criar, exibir e operar uma caixa de mensagem.
Sintaxe
PWLX_MESSAGE_BOX PwlxMessageBox;
int PwlxMessageBox(
[in] HANDLE hWlx,
[in] HWND hwndOwner,
[in] LPWSTR lpszText,
[in] LPWSTR lpszTitle,
[in] UINT fuStyle
)
{...}
Parâmetros
[in] hWlx
Especifica o identificador Winlogon passado para GINA na chamada WlxInitialize .
[in] hwndOwner
Especifica a janela proprietário da caixa de mensagem a ser criada. Se esse parâmetro for NULL, a caixa de mensagem não terá nenhuma janela de proprietário.
[in] lpszText
Aponta para uma cadeia de caracteres terminada em nulo que contém a mensagem a ser exibida.
[in] lpszTitle
Aponta para uma cadeia de caracteres terminada em nulo usada para o título da caixa de diálogo. Se esse parâmetro for NULL, o título padrão Error será usado.
[in] fuStyle
Especifica o conteúdo e o comportamento da caixa de diálogo. Esse parâmetro pode ser uma combinação dos seguintes valores.
| Valor | Significado |
|---|---|
|
A caixa de mensagem contém três botões de comando: Anular, Repetir e Ignorar. |
|
O usuário deve responder à caixa de mensagem antes de continuar a trabalhar na janela identificada pelo parâmetro hWndOwner . No entanto, o usuário pode mover para janelas de outros aplicativos para trabalhar.
Dependendo da hierarquia de janelas no aplicativo, o usuário pode ser capaz de mover para outras janelas dentro do aplicativo. Todas as janelas filho do pai da caixa de mensagem são desabilitadas automaticamente, mas as janelas pop-up não são. MB_APPLMODAL será o valor padrão se nem MB_SYSTEMMODAL nem MB_TASKMODAL forem especificados. |
|
A área de trabalho que está recebendo entrada no momento deve ser uma área de trabalho padrão; caso contrário, a função falhará. Uma área de trabalho padrão é aquela em que um aplicativo é executado após o logon do usuário. |
|
O primeiro botão é o botão padrão. Observe que o primeiro botão é sempre o padrão, a menos que MB_DEFBUTTON2 ou MB_DEFBUTTON3 seja especificado. |
|
O segundo botão é um botão padrão. |
|
O terceiro botão é um botão padrão. |
|
O quarto botão é um botão padrão. |
|
Um ícone que consiste em uma letra minúscula em um círculo aparece na caixa de mensagem. |
|
Um ícone de ponto de exclamação aparece na caixa de mensagem. |
|
Um ícone de mão aparece na caixa de mensagem. |
|
Um ícone que consiste em uma letra minúscula em um círculo aparece na caixa de mensagem. |
|
Um ícone de ponto de interrogação aparece na caixa de mensagem. |
|
Um ícone de sinal de parada aparece na caixa de mensagem. |
|
A caixa de mensagem contém um botão de comando: OK. |
|
A caixa de mensagem contém dois botões de comando: OK e Cancelar. |
|
A caixa de mensagem contém dois botões de comando: Repetir e Cancelar. |
|
O chamador é um serviço que notifica o usuário sobre um evento. A função abre uma caixa de mensagem na área de trabalho ativa atual, mesmo que não haja nenhum usuário conectado ao computador. |
|
A caixa de mensagem se torna a janela em primeiro plano. Internamente, o Windows chama a função SetForegroundWindow para a caixa de mensagem. |
|
Todos os aplicativos são suspensos até que o usuário responda à caixa de mensagem. A menos que o aplicativo especifique MB_ICONHAND, a caixa de mensagem não se tornará modal até que seja criada. Consequentemente, a janela do proprietário e outras janelas continuam recebendo mensagens resultantes de sua ativação. Use caixas de mensagens modais do sistema para notificar o usuário de erros graves e potencialmente prejudiciais que exigem atenção imediata, por exemplo, ficando sem memória. |
|
O mesmo que MB_APPLMODAL exceto que todas as janelas de nível superior que pertencem à tarefa atual serão desabilitadas se o parâmetro hWndOwner for NULL. Use esse sinalizador quando o aplicativo ou biblioteca de chamada não tiver um identificador de janela disponível, mas ainda precisar impedir a entrada para outras janelas no aplicativo atual sem suspender outros aplicativos. |
|
A caixa de mensagem contém dois botões de comando: Sim e Não. |
|
A caixa de mensagem contém três botões de comando: Sim, Não e Cancelar. |
Retornar valor
Se a função falhar ou se não houver memória suficiente para criar a caixa de mensagem, o valor retornado será zero.
Se a função for bem-sucedida, o valor retornado será um dos seguintes valores de item de menu retornados pela caixa de diálogo.
| Código de retorno | Descrição |
|---|---|
|
O botão Anular foi selecionado. |
|
O botão Cancelar foi selecionado. |
|
O botão Ignorar foi selecionado. |
|
Um botão não foi selecionado. |
|
O botão OK foi selecionado. |
|
O botão Repetir foi selecionado. |
|
O botão Sim foi selecionado. |
Comentários
A função WlxMessageBox não manipula eventos SAS e não é adequada para caixas de diálogo de segurança. Use a função WlxDialogBox, WlxDialogBoxIndirect ou WlxDialogBoxIndirectParam para caixas de diálogo de segurança.
WlxMessageBox duplica a função MessageBox do Windows, com a exceção de que essa função também permite que o Winlogon atue o tempo limite na caixa de diálogo. Para obter mais informações, consulte MessageBox.
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 |