TdhEnumerateManifestProviderEvents, fonction (tdh.h)

  • Article

La fonction TdhEnumerateManifestProviderEvents récupère la liste des événements présents dans le manifeste du fournisseur.

Syntaxe

TDHSTATUS TdhEnumerateManifestProviderEvents(
  [in]      LPGUID               ProviderGuid,
  [out]     PPROVIDER_EVENT_INFO Buffer,
  [in, out] ULONG                *BufferSize
);

Paramètres

[in] ProviderGuid

GUID qui identifie le fournisseur de manifeste dont vous souhaitez récupérer la liste des événements.

[out] Buffer

Mémoire tampon allouée par l’utilisateur pour recevoir la liste des événements. Pour plus d’informations, consultez la structure PROVIDER_EVENT_INFO .

[in, out] BufferSize

Taille, en octets, de la mémoire tampon pointée par le paramètre ProviderInfo . 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_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 ProviderInfo 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 paramètres ne sont pas valides.
ERROR_NOT_FOUND
 Les informations de schéma pour le GUID du 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

TdhGetManifestEventInformation