Udostępnij za pośrednictwem

StopAndAnalyzeTracingSessionA

  • Artykuł

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 StopAndAnalyzeTracingSessionA 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

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

Parametry

sessionName
Nazwa sesji śledzenia do zatrzymania. Użyj tej samej nazwy sesji co przekazana do elementu StartTracingSession, StartTracingSessionA lub StartTracingSessionW.

statystyki
Wskaźnik do obiektu TRACING_SESSION_STATISTICS . StopAndAnalyzeTracingSessionA zapisuje statystyki zbierania danych śledzenia w tym obiekcie przed zwróceniem.

analysisDescriptor
Wskaźnik do obiektu ANALYSIS_DESCRIPTOR . Użyj tego obiektu, aby skonfigurować sesję analizy uruchomioną przez StopAndAnalyzeTracingSessionAprogram .

Wartość zwracana

Kod wyniku z wyliczenia RESULT_CODE .