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 枚举中的结果代码。