次の方法で共有

StopAndAnalyzeTracingSessionA

  • [アーティクル]

C++ Build Insights SDK は、Visual Studio 2017 以降と互換性があります。 これらのバージョンのドキュメントを表示するには、この記事の Visual Studio バージョン セレクター コントロールを Visual Studio 2017 以降に設定します。 このページの目次の一番上にあります。

StopAndAnalyzeTracingSessionA 関数により、実行中のトレース セッションが停止されて、結果のトレースが一時ファイルに保存されます。 その後、その一時ファイルを入力として使用して、分析セッションが直ちに開始されます。 この関数を呼び出す実行可能ファイルには、管理者権限が必要です。

構文

enum RESULT_CODE StopAndAnalyzeTracingSessionA(
    const char*                 sessionName,
    TRACING_SESSION_STATISTICS* statistics,
    const ANALYSIS_DESCRIPTOR*  analysisDescriptor);

パラメーター

sessionName
停止するトレース セッションの名前。 StartTracingSession、StartTracingSessionA、StartTracingSessionW に渡したものと同じセッション名を使用します。

statistics
TRACING_SESSION_STATISTICS オブジェクトへのポインター。 StopAndAnalyzeTracingSessionA によって、戻る前に、このオブジェクトのトレース コレクション統計情報が書き込まれます。

analysisDescriptor
ANALYSIS_DESCRIPTOR オブジェクトへのポインター。 StopAndAnalyzeTracingSessionA によって開始される分析セッションを構成するには、このオブジェクトを使用します。

戻り値

RESULT_CODE 列挙型の結果コード。