ATLTRACE2 (DWORD カテゴリー、UINT レベル、LPCSTR lpszFormat、...）
パラメーター
カテゴリ
[入力]イベントまたはメソッドをレポートの種類を示すために、 atlTraceFlags 。「解説」を参照してくださいカテゴリの一覧について。
レベル
[入力]トレース レポートのレベル。ATL_TRACE_LEVEL表示の設定値以下である必要があります。レベル4 とATL_TRACE_LEVELを 0 に設定する場合は、たとえば、警告表示されません。解説 ATL_TRACE_LEVELについての詳細を参照してください。
lpszFormat
[入力]ダンプ デバイスに送信する、書式設定された文字列。
解説
ATLTRACE2をデバッグの目的で使用します。ATLTRACE2提供方法についてのメッセージ イベントおよびメソッドの happen.nbsp;ATLTRACE2警告と、プログラムをデバッグする場合に発生するエラーを報告します。ATLTRACE2を書式設定された文字列は、 lpszFormat、通常はデバッガーの出力ウィンドウまたはファイルをダンプ デバイスに送信します。(&N)。
ATLTRACE2、カテゴリーを最初のパラメーターを設定する、トレース フラグを示します。これらのフラグは、レポートの取得先のメソッドの種類に対応します。次の表に、カテゴリパラメーターを使用することができます、有効なトレース フラグを示します。
| カテゴリ | 説明 |
| atlTraceUser | アプリケーション定義。値をレポートする警告のレベルを示します。 |
| atlTraceGeneral | ATL のすべてのアプリケーションについて報告します。既定値。 |
| atlTraceCOM | COM メソッドについて報告。 |
| atlTraceQI | QueryInterface 呼び出しのレポート。 |
| atlTraceRegistrar | レポート オブジェクトの登録。 |
| atlTraceRefcount | 参照カウントの変更レポート。 |
| atlTraceWindowing | Windows の方法、たとえばレポート無効なメッセージ マップ ID。 |
| atlTraceControls | レポート上のコントロール、コントロールまたはウィンドウが破棄されると、たとえば報告。 |
| atlTraceHosting | コンテナー内のクライアントがアクティブになるとメッセージは、たとえば、ホスト レポート。 |
| atlTraceDBClient | OLE DB コンシューマー テンプレートのレポート;たとえば GetData の呼び出しが失敗したとき、出力HRESULT含めることができます。 |
| atlTraceDBProvider | OLE DB プロバイダー テンプレートをレポート、たとえば、列の作成が失敗したかどうかを報告。 |
| atlTraceSnapin | MMC スナップイン アプリケーションについてレポート。 |
| atlTraceNotImpl | 指定された関数が実装されていないことを報告します。 |
例
//ATLTRACE2 の例int I = 1;ATLTRACE2 （atlTraceGeneral、4、"整数 = %d\n」、私は）;/出力: ' 整数 = 1'
特定のカテゴリおよびレベルのフィルターを適用することができます以下で説明する 2 つのグローバル関数を設定、プロジェクト レベルで。このようなプリプロセッサの定義のフィルターを指定するには、グローバル関数では、Stdafx.h 前に挿入、 #include lt;atlbase.h> ステートメント。
代わりに、プリプロセッサ ディレクティブ [プロジェクト 設定] ダイアログ ボックスで、フィルターを設定できます。C および C++タブをクリックし、グローバル [プリプロセッサの定義の編集] ボックスに挿入。
カテゴリとレベルを設定するには、次のグローバル関数を使用します。:
ATL_TRACE_CATEGORY 0 XFFFFFFFF
トレース カテゴリをフィルター処理するを設定します。既定では、 0 xffffffffのすべてのカテゴリを報告します。特定のカテゴリまたはカテゴリのセットをフィルター処理するには、トレースしたいカテゴリ名を0 xffffffffを置き換えます。ビットごとの OR を使用することができます 1 つ以上のカテゴリをフィルターする (|) 演算子。たとえば、設定がATL_TRACE_CATEGORY (atlTraceControls | atlTraceWindowing)は、 ATLTRACE2警告コントロールのウィンドウだけが表示されます。
ATL_TRACE_LEVEL 0
トレース レベルのフィルターを設定します。0、1、2、3、または 4 をすることができます。既定値は 0、最も深刻な問題のみ報告します。0 を表示するレポートのレベルを交換してください。たとえば、4 を指定すると、警告および情報メッセージのすべてのレベルを表示します。
参照してください。