Skip to content

Latest commit

 

History

History
42 lines (29 loc) · 2 KB

stop-tracing-session-w.md

File metadata and controls

42 lines (29 loc) · 2 KB
title description ms.date helpviewer_keywords
StopTracingSessionW
The C++ Build Insights SDK StopTracingSessionW function reference.
02/12/2020
C++ Build Insights
C++ Build Insights SDK
StopTracingSessionW
throughput analysis
build time analysis
vcperf.exe

StopTracingSessionW

::: moniker range="<=msvc-140"

The C++ Build Insights SDK is compatible with Visual Studio 2017 and later. To see the documentation for these versions, set the Visual Studio Version selector control for this article to Visual Studio 2017 or later. It's found at the top of the table of contents on this page.

::: moniker-end ::: moniker range=">=msvc-150"

The StopTracingSessionW function stops an ongoing tracing session and produces a raw trace file. Raw trace files can be passed to the Analyze, AnalzeA, and AnalyzeW functions to start an analysis session. Raw trace files can also be passed to the Relog, RelogA, and RelogW functions to start relogging session. Executables calling StopTracingSessionW must have administrator privileges.

Syntax

enum RESULT_CODE StopTracingSessionW(
    const wchar_t*              sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

Parameters

sessionName
The name of the tracing session to stop. Use the same session name as the one passed to StartTracingSession, StartTracingSessionA, or StartTracingSessionW.

outputLogFile
Path to the final output log file where the raw trace should be saved.

statistics
Pointer to a TRACING_SESSION_STATISTICS object. StopTracingSessionW writes trace collection statistics in this object before returning.

Return Value

A result code from the RESULT_CODE enum.

::: moniker-end