分享方式：

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
要在其中寫入重新記錄會話所產生的重新記錄追蹤的檔案。

統計
TRACING_SESSION_STATISTICS 物件的指標。 StopAndRelogTracingSessionA 在傳回之前，會寫入這個 物件的追蹤集合統計資料。

analysisDescriptor
RELOG_DESCRIPTOR 物件的指標。 使用此物件來設定 由 StopAndRelogTracingSessionA 啟動的重新記錄會話。

傳回值

來自 RESULT_CODE 列舉的結果碼。