StopAndRelogTracingSessionW
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 StopAndRelogTracingSessionW
interrompe uma sessão de rastreamento em andamento e salva o rastreamento resultante em um arquivo temporário. Em seguida, uma sessão de novo registro é iniciada imediatamente usando o arquivo temporário como uma entrada. O rastreamento com novo registro final produzido pela sessão de novo registro é salvo em um arquivo especificado pelo chamador. Os executáveis que chamam essa função devem ter privilégios de administrador.
Sintaxe
enum RESULT_CODE StopAndRelogTracingSessionW(
const wchar_t* sessionName,
const wchar_t* outputLogFile,
TRACING_SESSION_STATISTICS* statistics,
const RELOG_DESCRIPTOR* relogDescriptor);
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.
outputLogFile
O arquivo no qual gravar o rastreamento com novo registro produzido pela sessão de novo registro.
estatísticas
Ponteiro para um objeto TRACING_SESSION_STATISTICS. StopAndRelogTracingSessionW
grava estatísticas de coleção de rastreamento neste objeto antes de retornar.
analysisDescriptor
Ponteiro para um objeto RELOG_DESCRIPTOR. Use este objeto para configurar a sessão de registro em log iniciada por StopAndRelogTracingSessionW
.
Valor de retorno
Um código de resultado da enumeração RESULT_CODE.