Поделиться через

StopTracingSessionA

  • Статья

Пакет SDK для Сборки C++ совместим с Visual Studio 2017 и более поздними версиями. Чтобы увидеть документацию для этих версий, установите в данной статье селектор Версия Visual Studio в Visual Studio 2017 и более поздних версий. Он находится в верхней части оглавления на этой странице.

Функция StopTracingSessionA останавливает текущий сеанс трассировки и создает необработанный файл трассировки. Необработанные файлы трассировки можно передать в функции Analyze, AnalzeA и AnalyzeW для запуска сеанса анализа. Кроме того, необработанные файлы трассировки можно передать в функции Relog, RelogA и RelogW для запуска сеанса повторной записи в журнал. Исполняемые файлы, вызывающие StopTracingSessionA, должны иметь привилегии администратора.

Синтаксис

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

Параметры

sessionName
Имя останавливаемого сеанса трассировки. Используйте то же имя сеанса, которое было передано в StartTracingSession, StartTracingSessionA или StartTracingSessionW.

outputLogFile
Путь к окончательному выходному файлу журнала, в котором должны быть сохранены необработанные данные трассировки.

statistics
Указатель на объект TRACING_SESSION_STATISTICS. StopTracingSessionA записывает статистику сбора трассировки в этот объект перед возвратом.

Возвращаемое значение

Код результата из перечисления RESULT_CODE.