_CrtSetReportHook
İstemci tarafından tanımlanan raporlama işlevi, C çalışma zamanı hata ayıklama raporlama işlemine (yalnızca hata ayıklama sürümü) takma tarafından yüklenir.
_CRT_REPORT_HOOK _CrtSetReportHook(
_CRT_REPORT_HOOK reportHook
);
Parametreler
- reportHook
C çalışma zamanı kanca için yeni istemci tarafından tanımlanan Raporlama işlevini raporlama işlemi hata ayıklama.
Dönüş Değeri
Önceki istemci tanımlı raporlama işlevini verir.
Notlar
_CrtSetReportHookC çalışma zamanı hata ayıklama kütüphaneye raporlama işlemini kendi Raporlama işlevini kullanmak bir uygulama sağlar.Sonuç olarak, her _CrtDbgReport denir hata ayıklama raporu üretmek için uygulama işlevi ilk adlı raporu kullanıcının.Bu işlevselliği sağlayan özel ayırma türleri üzerinde odaklanmak veya rapor hedefleri yok yoluyla göndermek için hata ayıklama raporları süzme gibi işlemleri gerçekleştirmek bir uygulama _CrtDbgReport.Zaman _DEBUG tanımlı değilse, çağrılar _CrtSetReportHook ön işleme sırasında kaldırılır.
Daha güçlü bir sürümü için _CrtSetReportHook, bkz: _CrtSetReportHook2.
_CrtSetReportHook İlevi kurar yeni istemci tanımlı işlev belirtilen raporlama reportHook ve önceki istemci tarafından tanımlanan hook döner.Aşağıdaki örnek, nasıl bir istemci tarafından tanımlanan rapor kancası örneklenmiş olması gerektiğini gösterir:
int YourReportHook( int reportType, char *message, int *returnValue );
Burada reportType hata ayıklama rapor türü (_CRT_WARN, _CRT_ERROR, veya _CRT_ASSERT), message raporda yer alması için montajı hata ayıklama kullanıcı iletisi ve returnValue istemci tarafından tanımlanan tarafından belirtilen değere göre verilmesi gereken işlevi raporlama _CrtDbgReport.Kullanılabilir rapor türleri hakkında tam açıklama için bkz: _CrtSetReportMode işlev.
Başka hiçbir raporlama gibi istemci tarafından tanımlanan Raporlama işlevini tam hata ayıklama iletisi işleme, işlev dön TRUE.İşlev döndüğünde FALSE, _CrtDbgReport rapor türü modu ve dosya için geçerli ayarları kullanarak hata ayıklama raporu oluşturmak için çağrılır.Belirterek ek olarak, _CrtDbgReport dönüş değeri olarak returnValue, uygulama hata ayıklama kesme oluşup oluşmadığını da kontrol edebilirsiniz.Hata ayıklama raporu nasıl yapılandırılmış ve oluşturulan tam açıklaması için bkz: _CrtSetReportMode, _CrtSetReportFile, ve _CrtDbgReport.
Kanca özellikli diğer çalışma zamanı işlevlerini ve kendi istemci tarafından tanımlanan yazma hakkında daha fazla bilgi için işlevleri kanca, bkz: Hata Ayıklama Kanca İşlevi Yazma.
[!NOT]
Uygulamanız ile derlenmişse /clr ve uygulama çıkıldıktan sonra Raporlama işlevi ana denir, CLR herhangi CRT işlevlerinin Raporlama işlevini çağırırsa, bir özel durum oluşturur.
Gereksinimler
Yordam |
Gerekli başlık |
|---|---|
_CrtSetReportHook |
<crtdbg.h> |
Daha fazla uyumluluk bilgisi için Giriş altındaki Uyumluluk bölümüne bakın.
Kitaplıklar
Yalnızca C çalışma zamanı kitaplıklarının hata ayıklama sürümleri.
.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.