分享方式：

StopTracingSession

  • 文章

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 列舉的結果碼。