GetTraceEnableFlags, fonction (evntrace.h)
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] TRACELOGGER_HANDLE 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 :
- Appelez la fonction SetLastError pour définir la dernière erreur sur ERROR_SUCCESS.
- Appelez la fonction GetTraceEnableFlags pour récupérer les indicateurs d’activation.
- Si la valeur enable flags est 0, appelez la fonction GetLastError pour récupérer la dernière erreur connue.
- 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 |