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