StopAndRelogTracingSessionW

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 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 relog é então imediatamente iniciada usando o arquivo temporário como entrada. O rastreamento final reregistrado produzido pela sessão de reregistro é 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

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.

ficheiroDeRegistoDeSaída
O ficheiro no qual gravar o rasto relogado produzido pela sessão de relogação.

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

análiseDescritor
Ponteiro para um objeto do tipo RELOG_DESCRIPTOR. Use este objeto para configurar a sessão de relog iniciada pelo StopAndRelogTracingSessionW.

Valor de retorno

Um código de resultado do RESULT_CODE enum.