SetTraceCallback, fonction (evntrace.h)

La fonction SetTraceCallback spécifie une fonction EventCallback pour traiter les événements de la classe de trace d’événements spécifiée.

Syntaxe

ULONG WMIAPI SetTraceCallback(
  [in] LPCGUID         pGuid,
  [in] PEVENT_CALLBACK EventCallback
);

Paramètres

[in] pGuid

Pointeur vers le GUID de classe d’une classe de trace d’événements pour laquelle vous souhaitez recevoir des événements. Pour obtenir la liste des GUID de classe de fournisseur de noyau, consultez Constantes de l’enregistreur d’événements du noyau NT.

[in] EventCallback

Pointeur vers une fonction EventCallback utilisée pour traiter les événements appartenant à la classe de trace d’événements.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur système. Voici quelques erreurs courantes et leurs causes.

• ERROR_INVALID_PARAMETER

  Une des conditions suivantes est vraie :

  • pGuid a la valeur NULL.
  • EventCallback a la valeur NULL.

Remarques

Les consommateurs appellent cette fonction.

Vous ne pouvez spécifier qu’une seule fonction de rappel pour une classe de trace d’événements. Si vous spécifiez plusieurs fonctions de rappel pour la classe de trace d’événements, la dernière fonction de rappel reçoit les événements de cette classe de trace d’événements.

Pour empêcher la fonction de rappel de recevoir des événements pour la classe de trace d’événements, appelez la fonction RemoveTraceCallback . Le rappel cesse automatiquement de recevoir des rappels lorsque vous fermez la trace.

Vous pouvez utiliser cette fonction pour recevoir des événements écrits à l’aide de l’une des fonctions TraceEvent . Vous ne pouvez pas utiliser cette fonction pour consommer des événements d’un fournisseur qui a utilisé l’une des fonctions EventWrite pour journaliser les événements.

Configuration requise

Voir aussi

EventCallback

ProcessTrace

RemoveTraceCallback