_CrtSetReportMode
Určuje cíl nebo cíle pro konkrétní sestavu typ generované _CrtDbgReport a volání makra _CrtDbgReport _CrtDbgReportW, jako například _ASSERT, _ASSERTE makra, _ASSERT, _ASSERTE makra, _RPT, _RPTF, _RPTW, _RPTFW makra, a _RPT, _RPTF, _RPTW, _RPTFW makra (pouze ladicí verze).
int _CrtSetReportMode(
int reportType,
int reportMode
);
Parametry
reportType
Report type: _CRT_WARN, _CRT_ERROR, and _CRT_ASSERT.reportMode
Nové sestavy režim nebo režimy pro reportType.
Vrácená hodnota
Po úspěšném ukončení _CrtSetReportMode vrací předchozí sestava režim nebo režimy pro zadaný typ sestavy v reportType.Pokud je předána neplatná hodnota jako reportType nebo neplatný režim je určen pro reportMode, _CrtSetReportMode vyvolá obsluhu neplatný parametr popsaným v Ověření parametrů.Pokud je povoleno spuštění pokračovat, tato funkce nastaví errno na EINVAL a vrátí -1.Další informace naleznete v tématu Kód chyby, _doserrno, _sys_errlist a _sys_nerr.
Poznámky
_CrtSetReportModeUrčuje cíl výstupu pro _CrtDbgReport.Protože makra _ASSERT, _ASSERTE, _RPT, a _RPTF volání _CrtDbgReport, _CrtSetReportMode Určuje cíl výstupu text zadaný pomocí makra.
Při _DEBUG není definována, volání do _CrtSetReportMode jsou odebrány při úpravě před zpracováním.
Pokud není volání _CrtSetReportMode -li cíl výstupu zpráv, pak následující výchozí hodnoty jsou platné:
Uplatnění selhání a chyb přesměrováni na okno zprávy ladění.
Upozornění z aplikací systému Windows jsou odesílány do ladicího programu výstupní okno.
Varování aplikace konzoly nezobrazí.
Následující tabulka uvádí typy sestav, které jsou definovány v Crtdbg.h.
Typ sestavy |
Description |
|---|---|
_CRT_WARN |
Varování, zprávy a informace, které není nutné okamžitou pozornost. |
_CRT_ERROR |
Chyby, neodstranitelné chyby a problémy, které vyžadují okamžitou pozornost. |
_CRT_ASSERT |
Selhání výrazu (uplatněna výrazy, které vedou k FALSE). |
_CrtSetReportMode Funkce přiřadí novou sestavu režimu určeném v reportMode na typ sestavy v reportType a vrátí režim dříve definované sestavy pro reportType.Následující tabulka uvádí dostupné možnosti pro reportMode a výsledné chování _CrtDbgReport.Tyto možnosti jsou definovány jako bitové příznaky v Crtdbg.h.
Režim sestav |
_CrtDbgReport chování |
|---|---|
_CRTDBG_MODE_DEBUG |
Zpráva zapíše výstup okna ladicího programu. |
_CRTDBG_MODE_FILE |
Zapíše popisovač uživatelský soubor zprávy._CrtSetReportFileby měla být volána definovat konkrétní soubor nebo proud, který chcete použít jako cíl. |
_CRTDBG_MODE_WNDW |
Vytvoří zobrazení zprávu spolu se zprávou Abort, Retry, a Ignore tlačítka. |
_CRTDBG_REPORT_MODE |
Vrátí reportMode pro zadanou reportType: 1 _CRTDBG_MODE_FILE 2 _CRTDBG_MODE_DEBUG 4 _CRTDBG_MODE_WNDW |
Každý typ sestavy mohou být zaznamenány pomocí vůbec jeden, dva nebo tři režimy nebo žádný.Proto je možné mít více než jeden cíl definované pro typ jediné zprávy.Například následující fragment kódu způsobí selhání výrazu zasílají i do okna zprávy ladění a na stderr:
_CrtSetReportMode( _CRT_ASSERT, _CRTDBG_MODE_FILE | _CRTDBG_MODE_WNDW );
_CrtSetReportFile( _CRT_ASSERT, _CRTDBG_FILE_STDERR );
Navíc zpravodajské režim nebo režimy pro každý typ sestavy lze samostatně řídit.Je například možné určit, že reportType z _CRT_WARN být odeslána na výstupní řetězec ladění, zatímco _CRT_ASSERT být zobrazeny pomocí okna zprávy ladění a odeslána stderr, jako dříve ilustrované.
Požadavky
Rutina |
Požadované záhlaví |
Volitelné záhlaví |
|---|---|---|
_CrtSetReportMode |
<crtdbg.h> |
<errno.h> |
Další informace o kompatibilitě v tématu Kompatibilita v úvodu.
Knihovny: ladění verze Funkce knihovny CRT pouze.
Příklad
Viz téma report.
Ekvivalent v rozhraní .NET Framework
Nelze použít Použijte volání funkce standardní C, PInvoke. Další informace naleznete v tématu Příklady volání funkce platformy.