StopAndRelogTracingSessionW

  • Artigo
  • 2 minutos para o fim da leitura

o SDK do Build Insights do C++ é compatível com o Visual Studio 2017 e posterior. para ver a documentação dessas versões, defina o controle do seletor de versão Visual Studio para este artigo como Visual Studio 2017 ou posterior. Ele é encontrado na parte superior do Sumário nesta página.

A StopAndRelogTracingSessionW função interrompe uma sessão de rastreamento em andamento e salva o rastreamento resultante em um arquivo temporário. Uma sessão de reregistro em log é iniciada imediatamente usando o arquivo temporário como uma entrada. O rastreamento de relogin final produzido pela sessão de reregistro em log é 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 foi passado para StartTracingSession, StartTracingSessionAou StartTracingSessionW.

outputLogFile
O arquivo no qual gravar o rastreamento de relogin produzido pela sessão de reregistro em log.

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 esse objeto para configurar a sessão de reregistro em log iniciada pelo StopAndRelogTracingSessionW .

Valor Retornado

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