Fonction TdhGetManifestEventInformation (tdh.h)

  • Article

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