Função MessageBoxIndirectA (winuser.h)

Cria, exibe e opera uma caixa de mensagem. A caixa de mensagem contém texto e título de mensagem definidos pelo aplicativo, qualquer ícone e qualquer combinação de botões de push predefinidos.

Sintaxe

int MessageBoxIndirectA(
  [in] const MSGBOXPARAMSA *lpmbp
);

Parâmetros

[in] lpmbp

Tipo: const LPMSGBOXPARAMS

Um ponteiro para uma estrutura de MSGBOXPARAMS que contém informações usadas para exibir a caixa de mensagem.

Valor de retorno

Tipo: int

Se a função for bem-sucedida, o valor retornado será um dos seguintes valores de item de menu.

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 estiver selecionado. Se a caixa de mensagem não tiver botão Cancelar, pressionar ESC não terá efeito.

Se não houver memória suficiente para criar a caixa de mensagem, o valor retornado será zero.

Código/valor de retorno	Descrição
IDABORT 3	O botão Anular foi selecionado.
IDCANCEL 2	O botão Cancelar foi selecionado.
IDCONTINUE 11	O botão Continuar foi selecionado.
IDIGNORE 5	O botão ignorar foi selecionado.
IDNO do 7	O botão No foi selecionado.
IDOK 1	O botão OK foi selecionado.
IDRETRY 4	O botão Repetir foi selecionado.
IDTRYAGAIN 10	O botão Tentar Novamente foi selecionado.
IDYES 6	O botão Sim foi selecionado.

Observações

Quando você usa uma caixa de mensagem modal do sistema para indicar que o sistema está com pouca memória, as cadeias de caracteres apontadas pelo lpszText e lpszCaption membros da estrutura MSGBOXPARAMS não devem ser retiradas de um arquivo de recurso, pois uma tentativa de carregar o recurso pode falhar.

Se você criar uma caixa de mensagem enquanto uma caixa de diálogo estiver presente, use um identificador para a caixa de diálogo como o parâmetro hWnd. O parâmetro hWnd não deve identificar uma janela filho, como um controle em uma caixa de diálogo.

Nota

O cabeçalho winuser.h define MessageBoxIndirect como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll
conjunto de API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introduzido no Windows 8)

Consulte também

Conceitual

Caixas de diálogo

MSGBOXPARAMS

messagebox

MessageBoxEx

de referência de