GetTraceEnableLevel, fonction (evntrace.h)

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

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

Syntaxe

UCHAR WMIAPI GetTraceEnableLevel(
  [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 EnableLevel 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 GetTraceEnableLevel pour récupérer le niveau d’activation.
3. Si la valeur du niveau d’activation 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 définit le niveau d’activation sur 0 ; sinon, la fonction GetTraceEnableLevel a échoué avec la dernière erreur connue.

Notes

Les fournisseurs utilisent cette valeur pour contrôler la gravité des événements qu’elle génère. Par exemple, les fournisseurs peuvent utiliser cette valeur pour déterminer si elle doit générer des événements d’information, d’avertissement ou d’erreur.

Exemples

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

Spécifications

Voir aussi

GetTraceEnableFlags

GetTraceLoggerHandle