StopAndAnalyzeTracingSessionW

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 StopAndAnalyzeTracingSessionW-Funktion beendet eine laufende Ablaufverfolgungssitzung und speichert die resultierende Ablaufverfolgung in einer temporären Datei. Eine Analysesitzung wird dann sofort mit der temporären Datei als Eingabe gestartet. Ausführbare Dateien, die diese Funktion aufrufen, benötigen Administratorberechtigungen.

Syntax

enum RESULT_CODE StopAndAnalyzeTracingSessionW(
    const wchar_t*              sessionName,
    TRACING_SESSION_STATISTICS* statistics,
    const ANALYSIS_DESCRIPTOR*  analysisDescriptor);

Parameter

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

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

analysisDescriptor
Zeiger auf ein ANALYSIS_DESCRIPTOR-Objekt. Konfigurieren Sie mit diesem Objekt die Analysesitzung, die mit StopAndAnalyzeTracingSessionW gestartet wurde.

Rückgabewert

Ein Ergebniscode aus der Enumeration RESULT_CODE.