ZatrzymajSesjęŚledzenia

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

Obiekt wywołujący musi mieć uprawnienia administratora, aby korzystać z 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 do końcowego pliku logu, aby zapisać surowy ślad.

statystyki
Wskaźnik do obiektu TRACING_SESSION_STATISTICS . StopTracingSession zapisuje statystyki dotyczące zbierania śladów w tym obiekcie przed zwróceniem.

Wartość zwracana

Kod wyniku z enumeracji RESULT_CODE.