Freigeben über


StopTracingSession

Das C++ Build Insights SDK ist mit Visual Studio 2017 und höher kompatibel. Um die Dokumentation für diese Versionen anzuzeigen, legen Sie das Auswahlsteuerelement Version in Visual Studio für diesen Artikel auf Visual Studio 2017 oder höher fest. Es befindet sich am Anfang des Inhaltsverzeichnisses auf dieser Seite.

Die StopTracingSession-Funktion beendet eine laufende Ablaufverfolgungssitzung und generiert eine Ablaufverfolgungsdatei mit Rohdaten. Sie können Rohprotokolldateien an die Funktionen Analyze, AnalyzeAund AnalyzeW übergeben, um eine Analysesitzung zu starten. Sie können Rohverfolgungsdateien an die Funktionen Relog, RelogA und RelogW übergeben, um eine Neuprotokollierungssitzung zu starten.

Der Aufrufer muss über Administratorberechtigungen für die Verwendung StopTracingSessionverfügen.

Syntax

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);

Parameter

sessionName
Der Name der anzuhaltenden Ablaufverfolgungssitzung. Verwenden Sie denselben Sitzungsnamen wie für StartTracingSession, StartTracingSessionA oder StartTracingSessionW.

outputLogFile
Vollständiger Pfad der endgültigen Ausgabeprotokolldatei, um das Rohprotokoll zu speichern.

Statistiken
Zeiger auf ein TRACING_SESSION_STATISTICS-Objekt. StopTracingSession schreibt in dieses Objekt Sammlungsstatistiken zur Ablaufverfolgung, bevor es zurückgegeben wird.

Rückgabewert

Ein Ergebniscode aus der Enumeration RESULT_CODE.