StopAndAnalyzeTracingSessionAStopAndAnalyzeTracingSessionA

Zestaw SDK usługi Build Insights jest zgodny z programem Visual Studio 2017 lub nowszym.The C++ Build Insights SDK is compatible with Visual Studio 2017 and above. Aby zapoznać się z dokumentacją tych wersji, ustaw kontrolkę selektora wersji programu Visual Studio dla tego artykułu na visual Studio 2017 lub visual Studio 2019.To see the documentation for these versions, set the Visual Studio Version selector control for this article to Visual Studio 2017 or Visual Studio 2019. Znajduje się w górnej części spisu treści na tej stronie.It's found at the top of the table of contents on this page.

StopAndAnalyzeTracingSessionAFunkcja przerywa trwającą sesję śledzenia i zapisuje wynikowy ślad w pliku tymczasowym.The StopAndAnalyzeTracingSessionA function stops an ongoing tracing session and saves the resulting trace in a temporary file. Sesja analizy jest następnie natychmiast uruchamiana przy użyciu pliku tymczasowego jako dane wejściowe.An analysis session is then immediately started using the temporary file as an input. Pliki wykonywalne wywołujące tę funkcję muszą mieć uprawnienia administratora.Executables calling this function must have administrator privileges.

SkładniaSyntax

enum RESULT_CODE StopAndAnalyzeTracingSessionA(
    const char*                 sessionName,
    TRACING_SESSION_STATISTICS* statistics,
    const ANALYSIS_DESCRIPTOR*  analysisDescriptor);

ParametryParameters

sessionNamesessionName
Nazwa sesji śledzenia, która ma zostać zatrzymana.The name of the tracing session to stop. Użyj tej samej nazwy sesji, która została przeniesiona do StartTracingSession, StartTracingSessionAlub StartTracingSessionW.Use the same session name as the one passed to StartTracingSession, StartTracingSessionA, or StartTracingSessionW.

Statystykistatistics
Wskaźnik do obiektu TRACING_SESSION_STATISTICS .Pointer to a TRACING_SESSION_STATISTICS object. StopAndAnalyzeTracingSessionA zapisuje statystyki kolekcji śledzenia w tym obiekcie przed zwróceniem.StopAndAnalyzeTracingSessionA writes trace collection statistics in this object before returning.

analysisDescriptoranalysisDescriptor
Wskaźnik do obiektu ANALYSIS_DESCRIPTOR .Pointer to an ANALYSIS_DESCRIPTOR object. Ten obiekt służy do konfigurowania sesji analizy, która jest uruchamiana przez program StopAndAnalyzeTracingSessionA .Use this object to configure the analysis session that's started by StopAndAnalyzeTracingSessionA.

Wartość zwracanaReturn Value

Kod wyniku z wyliczenia RESULT_CODE .A result code from the RESULT_CODE enum.