次の方法で共有

StopAndRelogTracingSessionA

  • [アーティクル]

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

StopAndRelogTracingSessionA 関数により、実行中のトレース セッションが停止されて、結果のトレースが一時ファイルに保存されます。 その後、その一時ファイルを入力として使用して、再ログ記録セッションが直ちに開始されます。 再ログ記録セッションによって生成された最終的な再ログ記録されたトレースが、呼び出し元によって指定されたファイルに保存されます。 この関数を呼び出す実行可能ファイルには、管理者権限が必要です。

構文

enum RESULT_CODE StopAndRelogTracingSessionA(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics,
    const RELOG_DESCRIPTOR*     relogDescriptor);

パラメーター

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

outputLogFile
再ログ記録セッションによって生成される再ログ記録されたトレースを書き込むファイル。

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

analysisDescriptor
RELOG_DESCRIPTOR オブジェクトへのポインター。 StopAndRelogTracingSessionA によって開始される再ログ記録セッションを構成するには、このオブジェクトを使用します。

戻り値

RESULT_CODE 列挙型の結果コード。