Partilhar via


StartTracingSession

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 StartTracingSession inicia uma sessão de rastreamento. Os executáveis que chamam essa função devem ter privilégios de administrador.

Sintaxe

RESULT_CODE StartTracingSession(
    const char*                    sessionName,
    const TRACING_SESSION_OPTIONS& options);

RESULT_CODE StartTracingSession(
    const wchar_t*                 sessionName,
    const TRACING_SESSION_OPTIONS& options);

Parâmetros

sessionName
O nome da sessão de rastreamento a ser iniciada. Use o mesmo nome ao chamar StopTracingSession ou qualquer outra função de parada de rastreamento.

options
Ponteiro para um objeto TRACING_SESSION_OPTIONS. Use este objeto para selecionar quais eventos devem ser coletados pela sessão de rastreamento.

Valor de retorno

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