ZatrzymajSesjęŚledzeniaA

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 StopTracingSessionA 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. Nieprzetworzone pliki śledzenia można również przekazać do funkcji Relog, RelogA i RelogW, aby rozpocząć sesję ponownego rejestrowania. Pliki wykonywalne wywołujące StopTracingSessionA muszą mieć uprawnienia administratora.

Składnia

enum RESULT_CODE StopTracingSessionA(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

Parametry

sessionName
Nazwa sesji śledzenia do zatrzymania. Użyj tej samej nazwy sesji, jaka została przekazana do StartTracingSession, StartTracingSessionA lub StartTracingSessionW.

outputLogFile
Ścieżka do końcowego pliku dziennika wyjściowego, w którym ma zostać zapisany nieprzetworzony ślad.

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

Wartość zwracana

Kod wyniku z wyliczenia RESULT_CODE .