StopTracingSession

El SDK de C++ Build Insights funciona con Visual Studio 2017 y versiones posteriores. Para ver la documentación de estas versiones, establezca el control de selector de Versión de Visual Studio para este artículo en Visual Studio 2017 o versiones posteriores. Puede encontrar el selector en la parte superior de la tabla de contenido de esta página.

La función StopTracingSession detiene una sesión de seguimiento en curso y genera un archivo de seguimiento sin formato. Puede pasar archivos de seguimiento sin procesar a las funciones Analyze, AnalyzeA y AnalyzeW para iniciar una sesión de análisis. Se pueden pasar archivo de seguimiento sin procesar a las funciones Relog, RelogA y RelogW para iniciar una sesión de relogging.

Detener una sesión que recopila eventos del sistema requiere privilegios de administrador. La detención de una sesión que no recopila eventos del sistema requiere los permisos ETW adecuados.

Sintaxis

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

Parámetros

sessionName
Nombre de la sesión de seguimiento que se va a detener. Utilice el mismo nombre que use en la función start, como StartTracingSession o StartTracingSession2.

outputLogFile
Ruta de acceso completa del archivo de registro de salida final para guardar el seguimiento sin procesar.

estadísticas
Puntero a un objeto TRACING_SESSION_STATISTICS. StopTracingSession escribe estadísticas de recopilación de seguimiento en este objeto antes de devolverlo.

Valor devuelto

Código de resultado de la enumeración RESULT_CODE.