Udostępnij za pośrednictwem

StopTracingSession

  • 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 StopTracingSession zatrzymuje bieżącą sesję śledzenia i generuje nieprzetworzonego pliku śledzenia. Możesz przekazać nieprzetworzone pliki śledzenia do funkcji Analyze, AnalzeA i AnalyzeW , aby rozpocząć sesję analizy. Możesz przekazać nieprzetworzone pliki śledzenia do funkcji Relog, RelogA i RelogW, aby rozpocząć sesję ponownego rejestrowania.

Obiekt wywołujący musi mieć uprawnienia administratora do używania elementu StopTracingSession.

Składnia

inline RESULT_CODE StopTracingSession(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

inline RESULT_CODE StopTracingSession(
    const wchar_t*              sessionName
    const wchar_t*              outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

Parametry

sessionName
Nazwa sesji śledzenia do zatrzymania. Użyj tej samej nazwy sesji, która jest używana dla parametru StartTracingSession, StartTracingSessionA lub StartTracingSessionW.

outputLogFile
Pełna ścieżka końcowego pliku dziennika danych wyjściowych w celu zapisania nieprzetworzonego śledzenia.

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

Wartość zwracana

Kod wyniku z wyliczenia RESULT_CODE .