Sdílet prostřednictvím

StopTracingSession

  • Č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 StopTracingSession zastaví probíhající relaci trasování a vytvoří nezpracovaný trasovací soubor. Nezpracované trasovací soubory můžete předat funkcím Analyze, AnalzeA a AnalyzeW , aby se spustila relace analýzy. Nezpracované trasovací soubory můžete předat funkcím Relog, RelogA a RelogW , aby se spustila relace relogování.

Volající musí mít oprávnění správce k použití StopTracingSession.

Syntaxe

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
Název relace trasování, která se má zastavit. Použijte stejný název relace jako pro StartTracingSession, StartTracingSessionA nebo StartTracingSessionW.

outputLogFile
Úplná cesta k poslednímu výstupnímu souboru protokolu pro uložení nezpracovaného trasování.

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

Návratová hodnota

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