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


StopTracingSession

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

Функция StopTracingSession останавливает текущий сеанс трассировки и создает необработанный файл трассировки. Вы можете передать необработанные файлы трассировки функциям Analysis, AnalzeA и AnalysisW для запуска сеанса анализа. Вы можете передать необработанные файлы трассировки в функции Relog, RelogA и RelogW для запуска сеанса повторной записи.

Вызывающий объект должен иметь разрешения администратора для использования StopTracingSession.

Синтаксис

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);

Параметры

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

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

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

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

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