TdhGetEventInformation, fonction (tdh.h)

  • Article

Récupère les métadonnées relatives à un événement.

Syntaxe

TDHSTATUS TdhGetEventInformation(
  [in]      PEVENT_RECORD     Event,
  [in]      ULONG             TdhContextCount,
  [in]      PTDH_CONTEXT      TdhContext,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] PULONG            BufferSize
);

Paramètres

[in] Event

Enregistrement d’événement passé à votre rappel EventRecordCallback . Pour plus d’informations, consultez la structure EVENT_RECORD .

[in] TdhContextCount

Nombre d’éléments dans pTdhContext.

[in] TdhContext

Tableau de valeurs de contexte pour les événements WPP ou ETW classiques uniquement ; sinon, NULL. Pour plus d’informations, consultez la structure TDH_CONTEXT . Le tableau ne doit pas contenir de types de contexte en double.

[out] Buffer

Mémoire tampon allouée par l’utilisateur pour recevoir les informations d’événement. Pour plus d’informations, consultez la structure TRACE_EVENT_INFO .

[in, out] BufferSize

Taille, en octets, de la mémoire tampon pBuffer . Si la fonction réussit, ce paramètre reçoit la taille de la mémoire tampon utilisée. Si la mémoire tampon est trop petite, la fonction retourne ERROR_INSUFFICIENT_BUFFER et définit ce paramètre sur la taille de mémoire tampon requise. Si la taille de la mémoire tampon est égale à zéro à l’entrée, aucune donnée n’est retournée dans la mémoire tampon et ce paramètre reçoit la taille de mémoire tampon requise.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite. Sinon, cette fonction retourne l’un des codes de retour suivants en plus d’autres.

Code de retour Description
ERROR_INSUFFICIENT_BUFFER
 La taille de la mémoire tampon pBuffer est trop petite. Utilisez la taille de mémoire tampon requise définie dans pBufferSize pour allouer une nouvelle mémoire tampon.
ERROR_NOT_FOUND
 Le schéma de l’événement est introuvable.
ERROR_INVALID_PARAMETER
 Un ou plusieurs paramètres ne sont pas valides.
ERROR_FILE_NOT_FOUND
 L’attribut resourceFileName dans le manifeste contient l’emplacement du binaire du fournisseur. Lorsque vous inscrivez le manifeste, l’emplacement est écrit dans le Registre. TDH n’a pas pu trouver le fichier binaire en fonction de l’emplacement inscrit.
ERROR_WMI_SERVER_UNAVAILABLE
 Le service WMI n’est pas disponible.

Remarques

Si l’événement est un événement WPP ou ETW hérité, vous pouvez spécifier les informations de contexte utilisées pour faciliter l’analyse des informations d’événement. L’événement est un événement WPP si l’indicateur EVENT_HEADER_FLAG_TRACE_MESSAGE est défini dans le membre Indicateurs de EVENT_HEADER (voir le membre EventHeader de EVENT_RECORD). L’événement est un événement ETW hérité si l’indicateur EVENT_HEADER_FLAG_CLASSIC_HEADER est défini.

Exemples

Pour obtenir un exemple montrant comment récupérer des métadonnées relatives à un événement, consultez Utilisation de TdhFormatProperty pour consommer des données d’événement.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête tdh.h
Bibliothèque Tdh.lib
DLL Tdh.dll

Voir aussi

TdhGetEventMapInformation

TdhGetProperty