StopTracingSessionA

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 StopTracingSessionA-Funktion beendet eine laufende Ablaufverfolgungssitzung und generiert eine Ablaufverfolgungsdatei mit Rohdaten. Ablaufverfolgungsdateien mit Rohdaten können an die Funktionen Analyze, AnalyzeA und AnalyzeW übergeben werden, um eine Analysesitzung zu starten. Ablaufverfolgungsdateien mit Rohdaten können an die Funktionen Relog, RelogA und RelogW übergeben werden, um eine Neuprotokollierungssitzung zu starten. Ausführbare Dateien, die StopTracingSessionA aufrufen, benötigen Administratorberechtigungen.

Syntax

enum RESULT_CODE StopTracingSessionA(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

Parameter

sessionName
Der Name der anzuhaltenden Ablaufverfolgungssitzung. Verwenden Sie den gleichen Sitzungsnamen wie den, der an StartTracingSession, StartTracingSessionA oder StartTracingSessionW übergeben wurde.

outputLogFile
Pfad zur endgültigen Ausgabeprotokolldatei, in der die Rohdaten der Ablaufverfolgung gespeichert werden sollen.

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

Rückgabewert

Ein Ergebniscode aus der Enumeration RESULT_CODE.