Sdílet prostřednictvím

StopAndRelogTracingSessionA

  • Článek

Sada C++ Build Insights SDK je kompatibilní se sadou Visual Studio 2017 a novějšími verzemi. Pokud chcete zobrazit dokumentaci k těmto verzím, nastavte ovládací prvek selektoru verzí sady Visual Studio pro tento článek na Visual Studio 2017 nebo novější. Nachází se v horní části obsahu na této stránce.

Funkce StopAndRelogTracingSessionA zastaví probíhající trasovací relaci a uloží výsledné trasování do dočasného souboru. Relace přelogování se pak okamžitě spustí s použitím dočasného souboru jako vstupu. Konečné přelogované trasování vytvořené relací relogování se uloží do souboru určeného volajícím. Spustitelné soubory, které tuto funkci volají, musí mít oprávnění správce.

Syntaxe

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

Parametry

sessionName
Název relace trasování, která se má zastavit. Použijte stejný název relace jako název předaný startTracingSession, StartTracingSessionA nebo StartTracingSessionW.

outputLogFile
Soubor, do kterého se má zapisovat relogované trasování vytvořené relací relogování.

statistiky
Ukazatel na objekt TRACING_SESSION_STATISTICS . StopAndRelogTracingSessionA zapíše statistiku trasování kolekce v tomto objektu před vrácením.

analysisDescriptor
Ukazatel na objekt RELOG_DESCRIPTOR . Tento objekt použijte ke konfiguraci relace přelogování, která byla spuštěna StopAndRelogTracingSessionA.

Návratová hodnota

Kód výsledku z výčtu RESULT_CODE .