_CrtSetReportMode

Especifica o destino ou destinos para um tipo de relatório específico gerado por _CrtDbgReport e quaisquer macros que telefonar _CrtDbgReport, _CrtDbgReportW, sistema autônomo _ASSERT, _ASSERTE macros, _ASSERT, _ASSERTE macros, _RPT _RPTF, _RPTW, _RPTFW macros, e _RPT _RPTF, _RPTW, _RPTFW macros (somente a versão de depurar).

int _CrtSetReportMode( 
   int reportType,
   int reportMode 
);

Parâmetros

  • reportType
    Tipo de relatório: _CRT_WARN, _CRT_ERROR, e _CRT_ASSERT.

  • reportMode
    Novo modo de relatório ou modos de reportType.

Valor de retorno

Após a conclusão bem-sucedida, _CrtSetReportMode Retorna o modo de relatório anterior ou modos para o tipo de relatório especificado em reportType. Se um valor inválido for passado sistema autônomo reportType ou um modo inválido foi especificado para reportMode, _CrtSetReportMode chama o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essa função define errno para EINVAL e retorna -1. For more information, see errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

_CrtSetReportMode Especifica o destino de saída para _CrtDbgReport. Porque as macros _ASSERT, _ASSERTE, _RPT, e _RPTF telefonar _CrtDbgReport, _CrtSetReportMode Especifica o destino de saída de texto especificado com as macros.

Quando _DEBUG não foi definido, chamadas para _CrtSetReportMode serão removidos durante a pré-processamento.

Se você não chamar _CrtSetReportMode Para definir o destino de saída de mensagens, em seguida, os seguintes padrões estão em vigor:

  • Falhas de declaração e erros são direcionados para uma janela de mensagem de depurar.

  • Avisos de aplicativos do Windows são enviados para janela de saída o depurador na.

  • Avisos de aplicativos de console não são exibidos.

A tabela a seguir lista os tipos de relatório definidos no Crtdbg.h.

Tipo de relatório

Descrição

_CRT_WARN

Avisos, mensagens e informações que não precisam de atenção imediata.

_CRT_ERROR

Erros, problemas irrecuperáveis e problemas que exigem atenção imediata.

_CRT_ASSERT

Falhas de declaração (expressões confirmados que avaliar FALSE).

The _CrtSetReportMode função atribui o novo modo de relatório especificado em reportMode para o tipo de relatório especificado em reportType e retorna o modo de relatório definidos anteriormente para reportType. A tabela a seguir lista as opções disponível para reportMode e o comportamento resultante de _CrtDbgReport. Essas opções são definidas sistema autônomo sinalizadores de bit em Crtdbg.h.

Modo de relatório

Comportamento _CrtDbgReport

_CRTDBG_MODE_DEBUG

Grava a mensagem em janela de saída do depurador.

_CRTDBG_MODE_FILE

Grava a mensagem para um identificador de arquivo fornecido pelo usuário._CrtSetReportFile deve ser chamado para definir o arquivo específico ou fluxo para usar sistema autônomo destino.

_CRTDBG_MODE_WNDW

Cria uma caixa de mensagem para exibir a mensagem junto com o Abort, Retry, e Ignore botões.

_CRTDBG_REPORT_MODE

RetornareportMode para o especificado reportType:

1   _CRTDBG_MODE_FILE

2   _CRTDBG_MODE_DEBUG

4   _CRTDBG_MODE_WNDW

Cada tipo de relatório pode ser relatado usando um, dois ou três modos ou nenhum modo todo.Portanto, é possível ter mais de um destino definido para um tipo de relatório único.Por exemplo, o fragmento de código a seguir causa falhas de declaração seja enviada para ambas uma janela de mensagem de depurar e stderr:

_CrtSetReportMode( _CRT_ASSERT, _CRTDBG_MODE_FILE | _CRTDBG_MODE_WNDW );
_CrtSetReportFile( _CRT_ASSERT, _CRTDBG_FILE_STDERR );

Além disso, a emissão de relatórios modos para cada tipo de relatório ou modo podem ser separadamente controlados.Por exemplo, é possível especificar que um reportType de _CRT_WARN ser enviados para uma seqüência de caracteres de depurar de saída, enquanto _CRT_ASSERT ser exibido usando uma janela de mensagem de depurar e enviadas para stderr, mostrado sistema autônomo previamente.

Requisitos

Rotina

Cabeçalho necessário

Cabeçalho opcional

_CrtSetReportMode

<crtdbg.h>

<errno.h>

Para obter mais informações de compatibilidade, consulte Compatibility na introdução.

Bibliotecas: Versões de depurar de C em time de execução bibliotecas somente.

Exemplo

Consulte Exemplo de Relatar: C Run-Time Depurando Relatar funções.

Equivalente do NET Framework

Não aplicável. Para telefonar a função C padrão, use PInvoke. For more information, see Exemplos de invocação de plataforma.

Consulte também

Referência

Rotinas de depurar