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 unformatierte Ablaufverfolgungsdateien an die Funktionen "Analysieren", "AnalzeA" und "AnalyzeW " übergeben, um eine Analysesitzung zu starten. Sie können unformatierte Ablaufverfolgungsdateien 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 zum Speichern der unformatierten Ablaufverfolgung.

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

Rückgabewert

Ein Ergebniscode aus der Enumeration RESULT_CODE.