C++ Build Insights SDK 与 Visual Studio 2017 及更高版本兼容。 若要查看这些版本对应的文档，请将本文的 Visual Studio“版本”选择器控件设置为 Visual Studio 2017 或更高版本。 它位于此页面上目录表的顶部。
StopAndAnalyzeTracingSession 函数用于停止正在进行的跟踪会话并将生成的跟踪保存在临时文件中。 然后，使用临时文件作为输入立即启动分析会话。 调用此函数的可执行文件必须具有管理员权限。
语法
template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
const char* sessionName,
unsigned numberOfAnalysisPasses,
TRACING_SESSION_STATISTICS* statistics,
StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);
template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
const wchar_t* sessionName,
unsigned numberOfAnalysisPasses,
TRACING_SESSION_STATISTICS* statistics,
StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);
参数
sessionName
要停止的跟踪会话的名称。 使用传递给 StartTracingSession、StartTracingSessionA 或 StartTracingSessionW 的相同会话名称。
numberOfAnalysisPasses
要在跟踪上运行的分析传递数。 每个分析传递通过提供的分析器组传递一次跟踪。
统计学
指向 TRACING_SESSION_STATISTICS 对象的指针。
StopAndAnalyzeTracingSession 在返回之前写入此对象中的跟踪集合统计信息。
analyzerGroup
用于分析的分析器组。 调用 MakeStaticAnalyzerGroup 以创建分析器组。 若要使用从 MakeDynamicAnalyzerGroup 中获取的动态分析器组，请先通过将其地址传递给 MakeStaticAnalyzerGroup 来将该组封装在静态分析器组内。
返回值
RESULT_CODE 枚举中的结果代码。