IStringTable::Enumerate, méthode (mmc.h)
La méthode IStringTable::Enumerate fournit un pointeur vers une interface IEnumString sur un énumérateur qui peut retourner les chaînes dans la table de chaînes d’un composant logiciel enfichable. L’interface IEnumString est une interface COM standard.
Syntaxe
HRESULT Enumerate(
[out] IEnumString **ppEnum
);
Paramètres
[out] ppEnum
Adresse de la variable pointeur IEnumString* qui reçoit le pointeur d’interface vers l’énumérateur. Si une erreur se produit, *ppEnum est défini sur NULL. Si *ppEnum n’a pas la valeur NULL, l’implémentation de IEnumString par MMC appelle IUnknown::AddRef sur le *ppEnum. Le composant logiciel enfichable doit appeler IUnknown::Release lorsque l’interface n’est plus nécessaire.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Notes
L’énumération IEnumString retournée représente un instantané de la collection de chaînes dans la table de chaînes sous-jacente l’heure à laquelle l’énumération a été récupérée. Ni IEnumString::Reset, ni IEnumString::Clone n’accepte une nouvelle instantané de la collection.
L’implémentation d’IEnumString utilise l’allocateur de mémoire de tâche OLE par défaut pour allouer de la mémoire aux chaînes qu’il retourne.
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |
| DLL | Mmcndmgr.dll |