StopTracingSession

[アーティクル]
07/19/2022

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

StopTracingSession 関数により、実行中のトレースセッションが停止されて、生のトレースファイルが生成されます。未加工のトレースファイルを Analyze、 AnalzeA、 AnalyzeW 関数に渡して、分析セッションを開始できます。未加工のトレースファイルを Relog、 RelogA、 RelogW 関数に渡して、再ログセッションを開始できます。

呼び出し元は、使用 StopTracingSessionする管理者のアクセス許可を持っている必要があります。

構文

inline RESULT_CODE StopTracingSession(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

inline RESULT_CODE StopTracingSession(
    const wchar_t*              sessionName
    const wchar_t*              outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

パラメーター

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

outputLogFile
生のトレースを保存する最終的な出力ログファイルの完全なパス。

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

戻り値

RESULT_CODE 列挙型の結果コード。