StopAndRelogTracingSessionWStopAndRelogTracingSessionW

Пакет SDK Аналитики сборок С++ совместим с Visual Studio 2017 и более поздних версий.The C++ Build Insights SDK is compatible with Visual Studio 2017 and above. Чтобы увидеть документацию для этих версий, установите в данной статье селектор Версия Visual Studio в Visual Studio 2017 или Visual Studio 2019.To see the documentation for these versions, set the Visual Studio Version selector control for this article to Visual Studio 2017 or Visual Studio 2019. Он находится в верхней части оглавления на этой странице.It's found at the top of the table of contents on this page.

Функция StopAndRelogTracingSessionW останавливает текущий сеанс трассировки и сохраняет итоговую трассировку во временном файле.The StopAndRelogTracingSessionW function stops an ongoing tracing session and saves the resulting trace in a temporary file. Затем сразу же запускается сеанс повторной записи в журнал с использованием временного файла в качестве входных данных.A relogging session is then immediately started using the temporary file as an input. Окончательные повторно записанные данные трассировки, созданные сеансом повторной записи в журнал, сохраняются в файле, указанном вызывающей стороной.The final relogged trace produced by the relogging session is saved in a file specified by the caller. Исполняемые файлы, вызывающие эту функцию, должны иметь привилегии администратора.Executables calling this function must have administrator privileges.

СинтаксисSyntax

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

ПараметрыParameters

sessionNamesessionName
Имя останавливаемого сеанса трассировки.The name of the tracing session to stop. Используйте то же имя сеанса, которое было передано в StartTracingSession, StartTracingSessionA или StartTracingSessionW.Use the same session name as the one passed to StartTracingSession, StartTracingSessionA, or StartTracingSessionW.

outputLogFileoutputLogFile
Файл, в который записываются повторно записанные данные трассировки, созданные сеансом повторной записи в журнал.The file in which to write the relogged trace produced by the relogging session.

statisticsstatistics
Указатель на объект TRACING_SESSION_STATISTICS.Pointer to a TRACING_SESSION_STATISTICS object. StopAndRelogTracingSessionW записывает статистику сбора трассировки в этот объект перед возвратом.StopAndRelogTracingSessionW writes trace collection statistics in this object before returning.

analysisDescriptoranalysisDescriptor
Указатель на объект RELOG_DESCRIPTOR.Pointer to a RELOG_DESCRIPTOR object. Используйте этот объект для настройки сеанса повторной записи в журнал, запущенного StopAndRelogTracingSessionW.Use this object to configure the relogging session that's started by StopAndRelogTracingSessionW.

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

Код результата из перечисления RESULT_CODE.A result code from the RESULT_CODE enum.