StopAndAnalyzeTracingSessionW

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 StopAndAnalyzeTracingSessionW 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

enum RESULT_CODE StopAndAnalyzeTracingSessionW(
    const wchar_t*              sessionName,
    TRACING_SESSION_STATISTICS* statistics,
    const ANALYSIS_DESCRIPTOR*  analysisDescriptor);

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.

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

análiseDescritor
Ponteiro para um objeto ANALYSIS_DESCRIPTOR . Use este objeto para configurar a sessão de análise iniciada pelo StopAndAnalyzeTracingSessionW.

Valor de retorno

Um código de resultado do RESULT_CODE enum.