ATLTRACE2 (dword Kategori, UINT düzeyi, LPCTSTR lpszFormat,...)
Parametreleri
kategori
[de] Olay veya yöntem hangi rapor türünü belirtmek için atlTraceFlags . Kategoriler listesi için bkz: Açıklamalar.
düzeyi
[de] Rapor izleme düzeyi. Görünmesi için atl_trace_level değere eşit veya daha küçük olmalıdır. Örneğin, size düzeyi 4 ve atl_trace_level için 0 olarak ayarlarsanız, hiçbir uyarı göreceksiniz. atl_trace_level hakkında daha fazla bilgi için Açıklamalar ' a bakın.
lpszFormat
[de] Döküm aygıta göndermek için biçimlendirilmiş dize.
Açıklamalar
ATLTRACE2 , hata ayıklama amacıyla kulla&nın. ATLTRACE2 sağlayan iletileri ilgili olaylar ve yöntemleri happen.nbsp; ATLTRACE2 , uyarılar ve programda hata ayıklamak gibi oluşan hataları raporlar. ATLTRACE2 biçemli bir dizge, lpszFormat, bir döküm genellikle hata ayıklayıcı output penceresi veya cihaza dosya gönderir.
ATLTRACE2, Kategori, ilk parametresi için izleme bayrakları listeler. Bu bayraklar raporlamak istediğiniz yöntemleri türleri karşılık gelir. Aşağıdaki tablo, sen-ebilmek kullanma Kategori parametre için geçerli izleme bayrakları listeler.
| Kategori | Açıklama |
| atlTraceUser | Uygulama tanımlı. Uyarı için rapor düzeyi değerini gösterir. |
| atlTraceGeneral | Tüm atl uygulamaları raporlar. Varsayılan. |
| atlTraceCOM | Com yöntemleri ile ilgili raporlar. |
| atlTraceQI | QueryInterface çağrılarını raporlar. |
| atlTraceRegistrar | Nesneler ve kayıt ile ilgili raporlar. |
| atlTraceRefcount | Başvuru sayısı değişen raporları. |
| atlTraceWindowing | Windows yöntemleri, örneğin raporları geçersiz ileti göster kimliği. |
| atlTraceControls | Denetimleri raporları, bir denetim veya penceresi yok örneğin raporlar. |
| atlTraceHosting | Rapor iletileri, örneğin, bir istemci bir konteyner etkinleştirildiğinde barındırma. |
| atlTraceDBClient | Ole db tüketici şablonu raporlarda; Örneğin GetData çağrısı başarısız olduğunda, çıkış hresult içerebilir. |
| atlTraceDBProvider | Ole db sağlayıcısı şablona raporları, örneğin bir sütun oluşturulamadı, raporları. |
| atlTraceSnapin | Raporlar için mmc ek bileşenini kullanma. |
| atlTraceNotImpl | Belirtilen işlev uygulanmadı raporları. |
Örnek
/ / ATLTRACE2 Örneğin
int i = 1;
ATLTRACE2 (atlTraceGeneral, 4, "Integer = %d\n", ı);
/ / Çıkış: ' tamsayı = 1'
Özel kategoriler ve düzeyleri için süzebilirsiniz aşağıda açıklanan iki küresel işlev ayarlayarak proje düzeyinde. Böyle Önişlemci tanımlarında filtre belirtmek için Stdafx.h önce küresel işlevler eklemek #include lt;atlbase.h> deyimi.
Alternatif olarak, Önişlemci direktifleri Proje ayarları iletişim kutusunda filtre ayarlayabilirsiniz. c/c++ sekmesini ve ardından genel Önişlemci tanımlarını düzenleme kutusuna ekleme.
Kategoriler ve düzeylerini ayarlamak için aşağıdaki genel işlevleri kullanabilirsiniz.:
ATL_TRACE_CATEGORY 0XFFFFFFFF
İzleme Kategori için filtre uygulamak üzere ayarlar. Varsayılan olarak, tüm kategoriler için 0xFFFFFFFF bildirir. Bir özel kategori veya kategoriler için filtre uygulamak için 0xFFFFFFFF izlemek istediğiniz kategori adlarını değiştirin. Bit düzey veya kullanabileceğiniz birden fazla kategori için filtre (|) işleci. Örneğin ayarlayarak atl_trace_category (atlTraceControls | atlTraceWindowing), yalnızca ATLTRACE2 uyarılar denetimleri ve pencere göreceksiniz.
atl_trace_level 0
Filtre uygulamak istediğiniz izleme düzeyini ayarlar. 0, 1, 2, 3 Veya 4 olabilir. Varsayılan olarak 0, sadece en ciddi sorunları raporlar. 0, Görmek istediğiniz rapor düzeyi ile değiştirin. Örneğin, 4 belirterek, uyarıları ve bilgi iletileri her düzeyde göreceksiniz.
Atl makrolar ve Global Functions
Ayrıca bkz: