Partilhar via

StopTracingSession

  • 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 StopTracingSession interrompe uma sessão de rastreamento em andamento e produz um arquivo de rastreamento bruto. Você pode passar arquivos de rastreamento brutos para as funções Analyze, AnalyzeAe AnalyzeW para iniciar uma sessão de análise. Você pode passar arquivos de rastreamento brutos para as funções Relog, RelogAe RelogW para iniciar uma sessão de novo registro em log.

O chamador deve ter permissões de administrador para usar StopTracingSession.

Sintaxe

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
O nome da sessão de rastreamento a ser interrompida. Use o mesmo nome de sessão usado para StartTracingSession, StartTracingSessionAou StartTracingSessionW.

outputLogFile
Caminho completo do arquivo de log de saída final para salvar o rastreamento bruto.

estatísticas
Ponteiro para um objeto TRACING_SESSION_STATISTICS. StopTracingSession 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.