次の方法で共有

ATLTraceTool サンプル:ATLTRACE2 の出力を表示します。

  • [アーティクル]

ATLTraceTool サンプルでは、出力ウィンドウに表示される ATLTRACE2 メッセージを指定するアプリケーションをビルドします。 この ATL Trace Tool アプリケーションは、ATL ソースと MFC ソースにデバッグ トレース メッセージを表示します。 表示されるメッセージの種類と容量は制御できます。

AtlTraceTool.exe は Visual Studio に付属しており、\Program Files\Microsoft Visual Studio 9.0\Common7\Tools ディレクトリにあります。 AtlTraceTool.exe も、 の [ツール] メニュー、開発環境から利用できます。

セキュリティに関するメモセキュリティに関するメモ

このサンプル コードは概念を示すためのものであり、その概念に関連するコードのみを示しています。特定の環境について必ずしもセキュリティ要件を満たしていませんので、そのまま使用しないでください。セキュリティおよびエラー処理コードを追加して、プロジェクトをより安全かつ堅牢にすることをお勧めします。これらのサンプル コードは、現状有姿のままで提供されるものであり、一切保証されていません。

サンプルとそのインストール手順を取得するには

Visual Studio のサンプルにアクセスするには

  • [ヘルプ] メニューの [サンプル] をクリックします。

    既定では、これらのサンプルは drive:\Program Files\Microsoft Visual Studio 10.0\Samples\ にインストールされています。

  • このサンプルの最新版および他のサンプルの一覧については、MSDN Web サイト上で Visual Studio サンプル 」を参照してください。

サンプルのビルドと実行

このサンプルをビルドして実行するには

  1. ソリューション ファイル tracetool.sln を開きます。

  2. [ビルド] メニューの [ビルド] をクリックします。

  3. メニューの [デバッグ、 デバッグなしで開始] をクリックします。

注意

この処理手順は省略できます。必要に応じて、ビルド済みの AtlTraceTool.exe を使用できます。

ATLTraceTool.exe を使用するには

  1. スタート デバッグ メニューをクリックして、MFC または ATL プロジェクトをデバッグします。

  2. 既に実行されていない場合は、 から MFC または ATL トレース ツール をクリックします。

  3. [ツリー コントロール] ボックスの一覧でトレース リスト ウィンドウを展開します。 このウィンドウには、実行中のアプリケーション、そのアプリケーション内のすべてのモジュール、および各モジュールのトレース カテゴリが表示されます。

  4. 各プロセス、モジュール、およびカテゴリについて、出力ウィンドウに表示する情報をカスタマイズします。 The Trace level control in the Process group is related to the ATLTRACE2 level; only those ATLTRACE2 messages with a level equal to or greater than the setting in the Trace level control will be displayed in the output window.

  5. 配置の設定を有効にするには適用 をクリックします。

設定を保存し、次回、アプリケーションをデバッグすると、読み込むことができます。保存先の 負荷 ボタンとボタンを使用します。

ATL Trace Tool のユーザー インターフェイス

  • [Trace List]
    デバッグ ATL/MFC ソースを使用するプロセスの一覧があるツリー コントロール。 各プロセスの下にモジュールが一覧表示され、各モジュールの下にはトレース カテゴリが一覧表示されます。

  • Refresh
    プロセスおよびトレース リスト モジュールの一覧を更新します。

  • [Process Group]
    以下に示すようなプロセス全体の設定です。

    [Trace level] – ATLTRACE2 を呼び出す場合のトレース レベル パラメーターと同じです。 現在、ATL/MFC ソースでは、トレース レベル 0 ～ 4 を使用します。0 は最も重大なレベルです。

    [Enabled] – プロセスのトレースを有効にします。

    [Category & Function Names] – トレース カテゴリと関数名をトレース メッセージに組み込みます。

    [File Name & Line No.] – トレース メッセージにファイル名と行番号を含めます。

  • [Module Group]
    このグループを有効にする前に、で Trace List ツリー コントロール最初のモジュールを選択する必要があります。 これらの設定はモジュールに影響します。

    [Trace level] – ATLTRACE2 を呼び出す場合のトレース レベル パラメーターと同じです。 現在、ATL/MFC ソースでは、トレース レベル 0 ～ 4 を使用します。0 は最も重大なレベルです。

    プロセス – プロセス でもこのモジュールを使用することを許可トレース設定を継承します。

    [Enabled] – このモジュールのトレースを有効にします。

    [Disabled] – このモジュールのトレースを無効にします。

  • [Category Group]
    このグループを有効にする前に、で Trace List ツリー コントロール最初はカテゴリを選択する必要があります。 これらの設定はモジュール内のカテゴリに影響します。

    [Trace level] – ATLTRACE2 を呼び出す場合のトレース レベル パラメーターと同じです。 現在、ATL/MFC ソースでは、トレース レベル 0 ～ 4 を使用します。0 は最も重大なレベルです。

    [Inherit from Module] – このカテゴリでも使用する [Module] グループでトレース設定を可能にします。Module

    [Enabled] – このカテゴリのトレースを有効にします。

    [Disabled] – このカテゴリのトレースを無効にします。

  • [上書き保存]
    現在のプロセスとその下のすべてのモジュールの設定を .trc ファイルに保存します。 負荷 ボタンを使用して、または AtlTraceLoadSettings の https://msdn.microsoft.com/ja-jp/library/ff0t40bw(v=vs.100) をプロジェクトから呼び出すことによって、.trc ファイルを読み込むことができます。 .trc ファイルが EXE/DLL と同じディレクトリにある場合、AtlTraceLoadSettings を呼び出してこのファイル名に NULL を渡すことができます。

  • Load
    .trc ファイルを読み込みます。

  • Apply
    読み込みまれたプロセスに現在の設定を適用します。

  • [Close]
    ATL/MFC トレース ツール ダイアログ ボックスを閉じます。 の適用を選択していない変更は影響しません。

  • ヘルプ
    ヘルプを表示します。

参照

その他の技術情報

ATL サンプル