Partager via

StopAndRelogTracingSessionA

  • Article

Le SDK Build Insights C++ est compatible avec Visual Studio 2017 et ultérieur. Pour consulter la documentation de ces versions, définissez le contrôle de sélecteur Version de Visual Studio pour cet article sur Visual Studio 2017 ou ultérieur. Il se trouve en haut de la table des matières de cette page.

La StopAndRelogTracingSessionA fonction arrête une session de suivi en cours et enregistre la trace résultante dans un fichier temporaire. Une session de relogging est alors immédiatement démarrée à l’aide du fichier temporaire en tant qu’entrée. La trace journalisée finale produite par la session de relogging est enregistrée dans un fichier spécifié par l’appelant. Les exécutables appelant cette fonction doivent disposer de privilèges d’administrateur.

Syntaxe

enum RESULT_CODE StopAndRelogTracingSessionA(
    const char*                 sessionName,
    const char*                 outputLogFile,
    TRACING_SESSION_STATISTICS* statistics,
    const RELOG_DESCRIPTOR*     relogDescriptor);

Paramètres

sessionName
Nom de la session de suivi à arrêter. Utilisez le même nom de session que celui passé à StartTracingSession, StartTracingSessionA ou StartTracingSessionW.

outputLogFile
Fichier dans lequel écrire la trace journalisée produite par la session de relogging.

statistiques
Pointeur vers un objet TRACING_SESSION_STATISTICS . StopAndRelogTracingSessionA écrit les statistiques de collection de traces dans cet objet avant de retourner.

analysisDescriptor
Pointeur vers un objet RELOG_DESCRIPTOR . Utilisez cet objet pour configurer la session de relogging démarrée par StopAndRelogTracingSessionA.

Valeur de retour

Code de résultat de l’énumération RESULT_CODE .