Fonction TdhEnumerateProviderFilters (tdh.h)

  • Article

La fonction TdhEnumerateProviderFilters énumère les filtres définis par le fournisseur spécifié dans le manifeste.

Syntaxe

TDHSTATUS TdhEnumerateProviderFilters(
  [in]            LPGUID                Guid,
  [in]            ULONG                 TdhContextCount,
  [in, optional]  PTDH_CONTEXT          TdhContext,
  [in]            ULONG                 *FilterCount,
  [out, optional] PPROVIDER_FILTER_INFO *Buffer,
  [in, out]       ULONG                 *BufferSize
);

Paramètres

[in] Guid

GUID qui identifie le fournisseur dont vous souhaitez récupérer les filtres.

[in] TdhContextCount

Non utilisé.

[in, optional] TdhContext

Non utilisé.

[in] FilterCount

Nombre de structures de filtre que contient la mémoire tampon pBuffer . Est égal à zéro si la mémoire tampon pBuffer est insuffisante.

[out, optional] Buffer

Mémoire tampon allouée par l’utilisateur pour recevoir les informations de filtre. Pour plus d’informations, consultez la structure PROVIDER_FILTER_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.

Remarques

Cette fonction utilise le manifeste XML pour récupérer les informations.

Configuration requise

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