Compartilhar via


StopAndRelogTracingSessionA

O SDK do C++ Build Insights é compatível com o Visual Studio 2017 e posterior. Para ver a documentação dessas versões, defina o controle seletor de Versão do Visual Studio deste artigo para o Visual Studio 2017 ou posterior. Ele é encontrado na parte superior da tabela de conteúdo nesta página.

A função StopAndRelogTracingSessionA interrompe uma sessão de rastreamento em andamento e salva o rastreamento resultante em um arquivo temporário. Em seguida, uma sessão de novo registro é iniciada imediatamente usando o arquivo temporário como uma entrada. O rastreamento com novo registro final produzido pela sessão de novo registro é salvo em um arquivo especificado pelo chamador. Os executáveis que chamam essa função devem ter privilégios de administrador.

Sintaxe

enum RESULT_CODE StopAndRelogTracingSessionA(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics,
    const RELOG_DESCRIPTOR*     relogDescriptor);

Parâmetros

sessionName
O nome da sessão de rastreamento a ser interrompida. Use o mesmo nome de sessão que o passado para StartTracingSession, StartTracingSessionA ou StartTracingSessionW.

outputLogFile
O arquivo no qual gravar o rastreamento com novo registro produzido pela sessão de novo registro.

estatísticas
Ponteiro para um objeto TRACING_SESSION_STATISTICS. StopAndRelogTracingSessionA grava estatísticas de coleção de rastreamento neste objeto antes de retornar.

analysisDescriptor
Ponteiro para um objeto RELOG_DESCRIPTOR. Use este objeto para configurar a sessão de registro em log iniciada por StopAndRelogTracingSessionA.

Valor de Devolução

Um código de resultado da enumeração RESULT_CODE.