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