Udostępnij za pośrednictwem

StopAndRelogTracingSessionA

  • 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 StopAndRelogTracingSessionA zatrzymuje bieżącą sesję śledzenia i zapisuje wynikowy ślad w pliku tymczasowym. Sesja rejestrowania jest następnie natychmiast uruchamiana przy użyciu pliku tymczasowego jako danych wejściowych. Ostatni ponowny ślad utworzony przez sesję rejestrowania jest zapisywany w pliku określonym przez obiekt wywołujący. Pliki wykonywalne wywołujące tę funkcję muszą mieć uprawnienia administratora.

Składnia

enum RESULT_CODE StopAndRelogTracingSessionA(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics,
    const RELOG_DESCRIPTOR*     relogDescriptor);

Parametry

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

outputLogFile
Plik, w którym ma być zapisywany relogged ślad wygenerowany przez sesję ponownego rejestrowania.

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

analysisDescriptor
Wskaźnik do obiektu RELOG_DESCRIPTOR . Użyj tego obiektu, aby skonfigurować sesję ponownego rejestrowania uruchomioną przez StopAndRelogTracingSessionAprogram .

Wartość zwracana

Kod wyniku z wyliczenia RESULT_CODE .