PararEAnalisarSessãoDeRastreamento

O C++ Build Insights SDK é compatível com o Visual Studio 2017 e posterior. 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. Encontra-se na parte superior do índice desta página.

A StopAndAnalyzeTracingSession função interrompe uma sessão de rastreamento em andamento e salva o rastreamento resultante em um arquivo temporário. Uma sessão de análise é então imediatamente iniciada usando o arquivo temporário como entrada. Os executáveis que chamam essa função devem ter privilégios de administrador.

Sintaxe

template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
    const char*                                   sessionName,
    unsigned                                      numberOfAnalysisPasses,
    TRACING_SESSION_STATISTICS*                   statistics,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);

template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
    const wchar_t*                                sessionName,
    unsigned                                      numberOfAnalysisPasses,
    TRACING_SESSION_STATISTICS*                   statistics,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);

Parâmetros

nome_da_sessão
O nome da sessão de rastreamento que se pretende interromper. Use o mesmo nome de sessão utilizado em StartTracingSession, StartTracingSessionAou StartTracingSessionW.

númeroDePassesDeAnálise
O número de passes de análise a executar no rastreamento. O rastreamento é passado pelo grupo de analisadores fornecido uma vez por passo de análise.

estatísticas
Ponteiro para um objeto TRACING_SESSION_STATISTICS. StopAndAnalyzeTracingSession grava estatísticas de coleta de rastreio neste objeto antes de retornar.

Grupo de Analisadores
O grupo analisador utilizado para a análise. Chame MakeStaticAnalyzerGroup para criar um grupo de analisadores. Se você deseja usar um grupo de analisadores dinâmicos obtido de MakeDynamicAnalyzerGroup, primeiro encapsula-o dentro de um grupo de analisadores estáticos passando seu endereço para MakeStaticAnalyzerGroup.

Valor de retorno

Um código de resultado do RESULT_CODE enum.