StopAndAnalyzeTracingSessionA

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 StopAndAnalyzeTracingSessionA interrompe uma sessão de rastreamento em andamento e salva o rastreamento resultante em um arquivo temporário. Em seguida, uma sessão de análise é iniciada imediatamente usando o arquivo temporário como uma entrada. Os executáveis que chamam essa função devem ter privilégios de administrador.

Sintaxe

enum RESULT_CODE StopAndAnalyzeTracingSessionA(
    const char*                 sessionName,
    TRACING_SESSION_STATISTICS* statistics,
    const ANALYSIS_DESCRIPTOR*  analysisDescriptor);

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.

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

analysisDescriptor
Ponteiro para um objeto ANALYSIS_DESCRIPTOR. Use este objeto para configurar a sessão de análise iniciada por StopAndAnalyzeTracingSessionA.

Valor de retorno

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