Compartilhar via


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.

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

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
MB_ABORTRETRYIGNORE
A caixa de mensagem contém três botões de comando: Anular, Repetir e Ignorar.
MB_APPLMODAL
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.

MB_DEFAULT_DESKTOP_ONLY
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.
MB_DEFBUTTON1
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.
MB_DEFBUTTON2
O segundo botão é um botão padrão.
MB_DEFBUTTON3
O terceiro botão é um botão padrão.
MB_DEFBUTTON4
O quarto botão é um botão padrão.
MB_ICONASTERISK
Um ícone que consiste em uma letra minúscula em um círculo aparece na caixa de mensagem.
MB_ICONEXCLAMATION
Um ícone de ponto de exclamação aparece na caixa de mensagem.
MB_ICONHAND
Um ícone de mão aparece na caixa de mensagem.
MB_ICONINFORMATION
Um ícone que consiste em uma letra minúscula em um círculo aparece na caixa de mensagem.
MB_ICONQUESTION
Um ícone de ponto de interrogação aparece na caixa de mensagem.
MB_ICONSTOP
Um ícone de sinal de parada aparece na caixa de mensagem.
MB_OK
A caixa de mensagem contém um botão de comando: OK.
MB_OKCANCEL
A caixa de mensagem contém dois botões de comando: OK e Cancelar.
MB_RETRYCANCEL
A caixa de mensagem contém dois botões de comando: Repetir e Cancelar.
MB_SERVICE_NOTIFICATION
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.
MB_SETFOREGROUND
A caixa de mensagem se torna a janela em primeiro plano. Internamente, o Windows chama a função SetForegroundWindow para a caixa de mensagem.
MB_SYSTEMMODAL
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.
MB_TASKMODAL
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.
MB_YESNO
A caixa de mensagem contém dois botões de comando: Sim e Não.
MB_YESNOCANCEL
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.

Nota Se uma caixa de mensagem tiver um botão Cancelar , a função retornará o valor IDCANCEL se a tecla ESC for pressionada ou o botão Cancelar for clicado. Se a caixa de mensagem não tiver nenhum botão Cancelar , pressionar ESC não terá efeito.
 
Código de retorno Descrição
IDABORT
O botão Anular foi selecionado.
IDCANCEL
O botão Cancelar foi selecionado.
IDIGNORE
O botão Ignorar foi selecionado.
IDNO
Um botão não foi selecionado.
IDOK
O botão OK foi selecionado.
IDRETRY
O botão Repetir foi selecionado.
IDYES
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

Confira também

Messagebox

Setforegroundwindow

WlxDialogBox

WlxDialogBoxIndirect

WlxDialogBoxIndirectParam

WlxInitialize