StopTracingSession

O C++ Build Insights SDK funciona com o Visual Studio 2017 e versões posteriores. Para ver a documentação destas versões, defina o controlo seletor de versão do Visual Studio para este artigo para Visual Studio 2017 ou posterior. Pode encontrar o seletor no topo do índice de conteúdos nesta página.

A função StopTracingSession interrompe uma sessão de rastreamento em andamento e produz um arquivo de rastreamento bruto. Pode passar arquivos de rastreamento brutos para as funções Analyze, AnalyzeA e AnalyzeW para iniciar uma sessão de análise. Você pode passar arquivos de rastreamento brutos para as funções Relog, RelogA e RelogW para iniciar uma sessão de relog.

Parar uma sessão que recolhe eventos do sistema requer privilégios de administrador. Parar uma sessão que não recolhe eventos do sistema requer permissões ETW apropriadas.

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 que se pretende interromper. Utilize o mesmo nome que usa na função de iniciação, como StartTracingSession ou StartTracingSession2.

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 escreve estatísticas de recolha de rastreamento neste objeto antes de regressar.

Valor de retorno

Um código de resultado do RESULT_CODE enum.