次の方法で共有

StopAndAnalyzeTracingSessionW

  • [アーティクル]

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

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

構文

enum RESULT_CODE StopAndAnalyzeTracingSessionW(
    const wchar_t*              sessionName,
    TRACING_SESSION_STATISTICS* statistics,
    const ANALYSIS_DESCRIPTOR*  analysisDescriptor);

パラメーター

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

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

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

戻り値

RESULT_CODE 列挙型の結果コード。