SetTraceCallback, fonction (evntrace.h)

  • Article

Important

N’utilisez pas cette fonction ; il est possible qu’il ne soit pas disponible dans les versions suivantes. Au lieu de cela, filtrez la classe de trace d’événements dans votre fonction EventRecordCallback .

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

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête evntrace.h
Bibliothèque Sechost.lib sur Windows 8.1 et Windows Server 2012 R2 ; Advapi32.lib sur Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista et Windows XP
DLL Sechost.dll sur Windows 8.1 et Windows Server 2012 R2 ; Advapi32.dll sur Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista et Windows XP

Voir aussi

EventCallback

ProcessTrace

RemoveTraceCallback