Partager via


Fonction TdhEnumerateProviders (tdh.h)

Récupère une liste de tous les fournisseurs qui se sont inscrits sur l’ordinateur.

Syntaxe

TDHSTATUS TdhEnumerateProviders(
  [out]     PPROVIDER_ENUMERATION_INFO pBuffer,
  [in, out] ULONG                      *pBufferSize
);

Paramètres

[out] pBuffer

Tableau de fournisseurs qui définissent publiquement leurs événements sur l’ordinateur. Pour plus d’informations, consultez la structure PROVIDER_ENUMERATION_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 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_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_INVALID_PARAMETER Un ou plusieurs des paramètres ne sont pas valides.

Remarques

Appelez la fonction TdhEnumerateProvidersForDecodingSource pour récupérer la liste des fournisseurs qui ont inscrit une classe MOF ou un fichier manifeste sur l’ordinateur.

Étant donné que le nombre de fournisseurs d’événements inscrits peut fluctuer entre les appels à cette fonction, vous devez placer cette fonction dans une boucle qui boucle jusqu’à ce que la valeur retournée ne soit plus ERROR_INSUFFICIENT_BUFFER.

Exemples

Pour obtenir un exemple qui montre comment énumérer des fournisseurs, consultez Énumération des fournisseurs.

Configuration requise

   
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

Voir aussi

TdhEnumerateProviderFieldInformation