Compartir vía

StopAndRelogTracingSessionW

  • Artículo

El SDK de C++ Build Insights es compatible 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. Se encuentra en la parte superior de la tabla de contenido de esta página.

La función StopAndRelogTracingSessionW detiene una sesión de seguimiento en curso y guarda el seguimiento resultante en un archivo temporal. Se inicia de inmediato una sesión de registro con el archivo temporal como entrada. El seguimiento registrado final generado por la sesión de registro se guarda en un archivo que especifica el autor de la llamada. Los ejecutables que llaman a esta función deben tener privilegios de administrador.

Sintaxis

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

Parámetros

sessionName
Nombre de la sesión de seguimiento que se va a detener. Use el mismo nombre de sesión que se pasó a StartTracingSession, StartTracingSessionA o StartTracingSessionW.

outputLogFile
Archivo en el que se va a escribir el seguimiento registrado generado por la sesión de registro.

estadísticas
Puntero a un objeto TRACING_SESSION_STATISTICS. StopAndRelogTracingSessionW escribe estadísticas de la colección de seguimientos en este objeto antes de devolver un valor.

analysisDescriptor
Puntero a un objeto RELOG_DESCRIPTOR. Use este objeto para configurar la sesión de registro iniciada por StopAndRelogTracingSessionW.

Valor devuelto

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