Compartilhar via


StopTracingSessionA

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 Analisar, AnalyzeAe 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.