Compartilhar via

StopTracingSessionA

  • Artigo

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 StopTracingSessionA interrompe uma sessão de rastreamento em andamento e produz um arquivo de rastreamento bruto. Os arquivos de rastreamento bruto podem ser passados para as funções Analyze, AnalyzeA e AnalyzeW para iniciar uma sessão de análise. Arquivos de rastreamento brutos também podem ser passados para as funções Relog, RelogA e RelogW para iniciar a sessão de recriação de registro. Os executáveis que chamam StopTracingSessionA devem ter privilégios de administrador.

Sintaxe

enum RESULT_CODE StopTracingSessionA(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

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
Caminho para o arquivo de log de saída final em que o rastreamento bruto deve ser salvo.

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

Valor de retorno

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