StopTracingSession

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 função StopTracingSession interrompe uma sessão de rastreamento em andamento e produz um arquivo de rastreamento bruto. Você pode passar arquivos de rastreamento brutos para as funções Analyze, AnalyzeA e AnalyzeW para iniciar uma sessão de análise. Você pode passar arquivos de rastreamento brutos para as funções Relog, RelogA e RelogW para iniciar uma sessão de relog.

O chamador deve ter permissões de administrador para usar StopTracingSessiono .

Sintaxe

inline RESULT_CODE StopTracingSession(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

inline RESULT_CODE StopTracingSession(
    const wchar_t*              sessionName,
    const wchar_t*              outputLogFile,
    TRACING_SESSION_STATISTICS* statistics);

Parâmetros

nome_da_sessão
O nome da sessão de rastreamento que se pretende interromper. Use o mesmo nome de sessão usado para StartTracingSession, StartTracingSessionA ou StartTracingSessionW.

ficheiroDeRegistoDeSaída
Caminho completo do arquivo de log de saída final para salvar o rastreamento bruto.

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

Valor de retorno

Um código de resultado do RESULT_CODE enum.