Méthode IStorage ::EnumElements (objidl.h)
La méthode EnumElements récupère un pointeur vers un objet énumérateur qui peut être utilisé pour énumérer les objets de stockage et de diffusion en continu contenus dans cet objet de stockage.
Syntaxe
HRESULT EnumElements(
[in] DWORD reserved1,
[in] void *reserved2,
[in] DWORD reserved3,
[out] IEnumSTATSTG **ppenum
);
Paramètres
[in] reserved1
Réservé pour une future utilisation ; doit être nul.
[in] reserved2
Réservé à une utilisation ultérieure ; doit avoir la valeur NULL.
[in] reserved3
Réservé pour une future utilisation ; doit être nul.
[out] ppenum
Pointeur vers la variable de pointeur IEnumSTATSTG* qui reçoit le pointeur d’interface vers le nouvel objet énumérateur.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
| S_OK | L’objet énumérateur a été retourné avec succès. |
| E_PENDING | Stockage asynchrone uniquement : une partie ou la totalité des données de l’élément n’est actuellement pas disponible. |
| STG_E_INSUFFICIENTMEMORY | L’objet énumérateur n’a pas pu être créé en raison d’un manque de mémoire. |
| STG_E_INVALIDPARAMETER | L’un des paramètres n’était pas valide. |
| STG_E_REVERTED | L’objet de stockage a été invalidé par une opération de restauration au-dessus de lui dans l’arborescence des transactions. |
Remarques
L’objet énumérateur retourné par cette méthode implémente l’interface IEnumSTATSTG , l’une des interfaces d’énumération standard qui contiennent les méthodes Next, Reset, Clone et Skip . IEnumSTATSTG énumère les données stockées dans un tableau de structures STATSTG .
L’objet de stockage doit être ouvert en mode lecture pour permettre l’énumération de ses éléments.
L’objet énumérateur est autorisé à énumérer les éléments dans n’importe quel ordre. L’objet énumérateur est également autorisé à traiter l’énumération comme un instantané ou à faire en sorte que l’énumération reflète l’état actuel de l’objet de stockage.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | objidl.h |
| Bibliothèque | Uuid.lib |
| DLL | Ole32.dll |