TdhGetEventMapInformation, fonction (tdh.h)

Article
08/26/2023

Récupère des informations sur le mappage d’événements contenu dans l’événement.

Syntaxe

TDHSTATUS TdhGetEventMapInformation(
  [in]      PEVENT_RECORD   pEvent,
  [in]      PWSTR           pMapName,
  [out]     PEVENT_MAP_INFO pBuffer,
  [in, out] ULONG           *pBufferSize
);

Paramètres

[in] pEvent

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

[in] pMapName

Chaîne Unicode terminée par null qui contient le nom de la valeur de l’attribut de carte. Le nom provient du membre MapNameOffset de la structure EVENT_PROPERTY_INFO .

[out] pBuffer

Mémoire tampon allouée par l’utilisateur pour recevoir le mappage d’événements. Il peut s’agir d’une carte de valeurs, d’une bitmap ou d’une carte de modèle. Pour plus d’informations, consultez la structure EVENT_MAP_INFO .

[in, out] pBufferSize

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 ou le mappage spécifié est introuvable.
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_INVALID_PARAMETER	Un ou plusieurs paramètres ne sont pas valides.
ERROR_WMI_SERVER_UNAVAILABLE	Le service WMI n’est pas disponible.

Remarques

Vous ne pouvez pas utiliser cette fonction pour récupérer des informations de mappage d’événements pour les événements WPP.

Pour les cartes définies dans un manifeste, la chaîne contient un espace à la fin de la chaîne. Par exemple, si la valeur est mappée à « Monday » dans le manifeste, la chaîne est retournée sous la forme « Monday ».

Exemples

Pour obtenir un exemple montrant comment appeler cette fonction, consultez Utilisation de TdhGetProperty 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

Partager via