StopAndAnalyzeTracingSession
Zestaw SDK usługi Build Insights języka C++ jest zgodny z programem Visual Studio 2017 lub nowszym. Aby zapoznać się z dokumentacją dla tych wersji, ustaw kontrolkę selektora wersji programu Visual Studio dla tego artykułu na program Visual Studio 2017 lub nowszy. Znajduje się on w górnej części spisu treści na tej stronie.
Funkcja StopAndAnalyzeTracingSession zatrzymuje bieżącą sesję śledzenia i zapisuje wynikowy ślad w pliku tymczasowym. Sesja analizy jest następnie natychmiast uruchamiana przy użyciu pliku tymczasowego jako danych wejściowych. Pliki wykonywalne wywołujące tę funkcję muszą mieć uprawnienia administratora.
Składnia
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);
Parametry
sessionName
Nazwa sesji śledzenia do zatrzymania. Użyj tej samej nazwy sesji co przekazana do elementu StartTracingSession, StartTracingSessionA lub StartTracingSessionW.
numberOfAnalysisPasses
Liczba przebiegów analizy do uruchomienia w śladzie. Dane śledzenia są przekazywane przez podaną grupę analizatorów raz na przekazanie analizy.
statystyki
Wskaźnik do obiektu TRACING_SESSION_STATISTICS . StopAndAnalyzeTracingSession zapisuje statystyki zbierania danych śledzenia w tym obiekcie przed zwróceniem.
analyzerGroup
Grupa analizatorów używana do analizy. Wywołaj metodę MakeStaticAnalyzerGroup , aby utworzyć grupę analizatorów. Jeśli chcesz użyć grupy analizatora dynamicznego uzyskanej z klasy MakeDynamicAnalyzerGroup, najpierw hermetyzuj ją wewnątrz grupy analizatora statycznego, przekazując jej adres do MakeStaticAnalyzerGroup.
Wartość zwracana
Kod wyniku z wyliczenia RESULT_CODE .