StopAndRelogTracingSessionW

  • Статья

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

Функция StopAndRelogTracingSessionW останавливает текущий сеанс трассировки и сохраняет итоговую трассировку во временном файле. Затем сразу же запускается сеанс повторной записи в журнал с использованием временного файла в качестве входных данных. Окончательные повторно записанные данные трассировки, созданные сеансом повторной записи в журнал, сохраняются в файле, указанном вызывающей стороной. Исполняемые файлы, вызывающие эту функцию, должны иметь привилегии администратора.

Синтаксис

enum RESULT_CODE StopAndRelogTracingSessionW(
    const wchar_t*              sessionName,
    const wchar_t*              outputLogFile,
    TRACING_SESSION_STATISTICS* statistics,
    const RELOG_DESCRIPTOR*     relogDescriptor);

Параметры

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

outputLogFile
Файл, в который записываются повторно записанные данные трассировки, созданные сеансом повторной записи в журнал.

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

analysisDescriptor
Указатель на объект RELOG_DESCRIPTOR. Используйте этот объект для настройки сеанса повторной записи в журнал, запущенного StopAndRelogTracingSessionW.

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

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