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 |