Fonction TdhGetManifestEventInformation (tdh.h)

Article
08/26/2023

La fonction TdhGetManifestEventInformation récupère les métadonnées relatives à un événement dans un manifeste.

Syntaxe

TDHSTATUS TdhGetManifestEventInformation(
  [in]      LPGUID            ProviderGuid,
  [in]      PEVENT_DESCRIPTOR EventDescriptor,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] ULONG             *BufferSize
);

Paramètres

[in] ProviderGuid

GUID qui identifie le fournisseur de manifeste dont vous souhaitez récupérer les métadonnées d’événement.

[in] EventDescriptor

Pointeur vers le descripteur d’événement qui contient des informations telles que l’ID d’événement, la version, le code d’opération et mot clé. Pour plus d’informations, consultez la structure EVENT_DESCRIPTOR

[out] Buffer

Mémoire tampon allouée par l’utilisateur pour recevoir les métadonnées relatives à un événement dans un manifeste de fournisseur. Pour plus d’informations, consultez la structure TRACE_EVENT_INFO .

[in, out] BufferSize

Taille, en octets, de la mémoire tampon pointée vers le paramètre Buffer . 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 à la taille de mémoire tampon requise. Si la taille de la mémoire tampon est égale à zéro lors de 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_EMPTY	Aucun événement n’est défini pour le GUID du fournisseur dans le manifeste.
ERROR_FILE_NOT_FOUND	Les métadonnées du fournisseur sont introuvables.
ERROR_INSUFFICIENT_BUFFER	La taille de la mémoire tampon pointée vers le paramètre Buffer est trop petite. Utilisez la taille de mémoire tampon requise définie dans le paramètre BufferSize pour allouer une nouvelle mémoire tampon.
ERROR_INVALID_PARAMETER	Un ou plusieurs des paramètres ne sont pas valides.
ERROR_NOT_FOUND	Les informations de schéma pour le GUID de fournisseur fourni sont introuvables.

Configuration requise

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

Voir aussi

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents

Partager via