GetTraceEnableFlags, fonction (evntrace.h)

  • Article

Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction GetTraceEnableFlags pour récupérer les indicateurs d’activation spécifiés par le contrôleur de trace afin d’indiquer la catégorie d’événements à suivre.

Les fournisseurs appellent cette fonction à partir de leur fonction ControlCallback .

Syntaxe

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACEHANDLE TraceHandle
);

Paramètres

[in] TraceHandle

Handle vers une session de suivi d’événements, obtenue en appelant la fonction GetTraceLoggerHandle .

Valeur retournée

Retourne la valeur spécifiée par le contrôleur dans le paramètre EnableFlag lors de l’appel de la fonction EnableTrace .

Pour déterminer si la fonction a échoué ou si le contrôleur a défini les indicateurs d’activation sur 0, procédez comme suit :

  1. Appelez la fonction SetLastError pour définir la dernière erreur sur ERROR_SUCCESS.
  2. Appelez la fonction GetTraceEnableFlags pour récupérer les indicateurs d’activation.
  3. Si la valeur enable flags est 0, appelez la fonction GetLastError pour récupérer la dernière erreur connue.
  4. Si la dernière erreur connue est ERROR_SUCCESS, le contrôleur a défini les indicateurs d’activation sur 0 ; sinon, la fonction GetTraceEnableFlags a échoué avec la dernière erreur connue.

Remarques

Les fournisseurs peuvent utiliser cette valeur pour contrôler les événements qu’elle génère. Par exemple, un fournisseur peut regrouper des événements en catégories logiques d’événements et utiliser cette valeur pour activer ou désactiver leur génération.

Exemples

Pour obtenir un exemple qui utilise GetTraceEnableFlags, consultez Récupération de données d’événement à l’aide de MOF.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête evntrace.h
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

GetTraceEnableLevel

GetTraceLoggerHandle