_CrtSetReportMode
Hedef veya hedefleri tarafından oluşturulan bir özel rapor türünü belirtir _CrtDbgReport ve çağrı herhangi bir makro _CrtDbgReport, _CrtDbgReportW, aþaðýdaki gibi _ASSERT, _ASSERTE Makroları, _ASSERT, _ASSERTE Makroları, _RPT, _RPTF, _RPTW, _RPTFW Makroları, ve _RPT, _RPTF, _RPTW, _RPTFW Makroları (yalnızca hata ayıklama sürümü).
int _CrtSetReportMode(
int reportType,
int reportMode
);
Parametreler
reportType
Rapor türü: _CRT_WARN, _CRT_ERROR ve _CRT_ASSERT.reportMode
Yeni rapor modu veya modları için reportType.
Dönüş Değeri
Başarıyla tamamlandığında, _CrtSetReportMode içinde belirtilen rapor türü için önceki rapor modu veya modları verir reportType.Geçersiz bir değer olarak geçirilen ise reportType veya geçersiz bir mod için belirtilen reportMode, _CrtSetReportMode açıklandığı gibi geçersiz bir parametre işleyiciyi çağırır Parametre Doğrulama.Yürütmenin devam etmesine izin verilirse, bu işlev errno öğesini EINVAL olarak ayarlar ve -1 döndürür.Daha fazla bilgi için bkz. errno, _doserrno, _sys_errlist, and _sys_nerr.
Notlar
_CrtSetReportModeÇıktı hedefi belirtir _CrtDbgReport.Çünkü makrolar _ASSERT, _ASSERTE, _RPT, ve _RPTF çağrı _CrtDbgReport, _CrtSetReportMode metin makroları ile belirtilen çıktı hedefini belirtir.
_DEBUG tanımlı olmadığında _CrtSetReportMode'e çağrılar ön işleme sırasında kaldırılır.
Arama, _CrtSetReportMode iletileri çıktı hedefini tanımlamak için sonra aşağıdaki varsayılan ayarlar etkindir:
Onaylama işlemi hatası ve hata için bir hata ayıklama iletisi penceresi yönlendirilir.
Windows uygulamalarından gelen uyarıları hata ayıklayıcı'nın output penceresine gönderilir.
Konsol uygulamaları gelen uyarıları görüntülenmez.
Crtdbg.h içinde tanımlanan rapor türleri aşağıdaki tabloda listelenmiştir.
Rapor türü |
Tanımlama |
|---|---|
_CRT_WARN |
Uyarı iletileri ve hemen ilgilenilmesi gereken değil bilgi. |
_CRT_ERROR |
Hatalar düzeltilemez sorun ve hemen ilgilenilmesi gereken sorunlar. |
_CRT_ASSERT |
Onaylama işlemi hatası (değerlendirmek için ifadeler garantilenen FALSE). |
_CrtSetReportMode İşlevi belirtilen yeni rapor modu atar reportMode belirtilen rapor türü için reportType ve önceden tanımlanmış rapor modunu döndürür reportType.Aşağıdaki tablo için kullanılabilir seçenekleri listeler reportMode ve ortaya çıkan davranış _CrtDbgReport.Bu seçenekler, Crtdbg.h'de bit bayrakları olarak tanımlanır.
Rapor modu |
_CrtDbgReport davranışı |
|---|---|
_CRTDBG_MODE_DEBUG |
İleti Hata Ayıklayıcı'nın output penceresine yazar. |
_CRTDBG_MODE_FILE |
İleti için kullanıcı tarafından sağlanan dosya tanıtıcı yazar._CrtSetReportFilebelirli dosya veya hedefi olarak kullanmak istediğiniz akışı tanımlamak için çağrılabilir. |
_CRTDBG_MODE_WNDW |
İleti ile birlikte görüntülemek için bir mesaj kutusu oluşturur Abort, Retry, ve Ignore düğmeleri. |
_CRTDBG_REPORT_MODE |
Döner reportMode için belirtilen reportType: 1 _CRTDBG_MODE_FILE 2 _CRTDBG_MODE_DEBUG 4 _CRTDBG_MODE_WNDW |
Her rapor türü hiç bir, iki veya üç modları veya hiçbir mod kullanarak raporlanabilir.Bu nedenle, bir tek rapor türü için birden fazla hedef olması mümkündür.Örneğin, aşağıdaki kod parçası bir iki hata ayıklama iletisi penceresi ve sistemi gönderilen onaylama işlemi hatası neden stderr:
_CrtSetReportMode( _CRT_ASSERT, _CRTDBG_MODE_FILE | _CRTDBG_MODE_WNDW );
_CrtSetReportFile( _CRT_ASSERT, _CRTDBG_FILE_STDERR );
Ayrıca, Raporlama modunda veya modları her rapor türü için ayrı ayrı kontrol edilebilir.Örneğin, belirtmek mümkündür bir reportType , _CRT_WARN olması bir çıkış hata ayıklama dizesi gönderildi, while _CRT_ASSERT olması bir hata ayıklama iletisi penceresi kullanılarak görüntülenir ve gönderilen stderr, yukarıda Resimli.
Gereksinimler
Yordam |
Gerekli başlık |
İsteğe bağlı üst bilgi |
|---|---|---|
_CrtSetReportMode |
<crtdbg.h> |
<errno.h> |
Daha fazla uyumluluk bilgisi için, Giriş'teki Uyumluluk başlığına bakın.
Kitaplıklar: Yalnızca CRT Kitaplık Özellikleri hata giderme sürümü.
.NET Framework Eşdeğeri
Uygulanamaz. Standart C işlevini çağırmak için PInvoke kullanın. Daha fazla bilgi için bkz. Platform Çağırma Örnekleri.