ZatrzymajSesjęŚledzenia

Zestaw SDK usługi Build Insights języka C++ współpracuje z Visual Studio 2017 i nowszymi wersjami. 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. Selektor można znaleźć w górnej części spisu treści na tej stronie.

Funkcja StopTracingSession zatrzymuje bieżącą sesję śledzenia i generuje nieprzetworzony plik śledzenia. Nieprzetworzone pliki śledzenia można przekazać do funkcji Analyze, AnalyzeAi AnalyzeW, aby rozpocząć sesję analizy. Możesz przekazać nieprzetworzone pliki śledzenia do funkcji Relog, RelogA i RelogW, aby rozpocząć sesję ponownego rejestrowania.

Zatrzymanie sesji, która zbiera zdarzenia systemowe, wymaga uprawnień administratora. Zatrzymanie sesji, która nie zbiera zdarzeń systemowych, wymaga odpowiednich uprawnień ETW.

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, której używasz w funkcji startowej, takiej jak StartTracingSession lub StartTracingSession2.

outputLogFile
Pełna ścieżka do końcowego pliku logu, aby zapisać surowy ślad.

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 enumeracji RESULT_CODE.