IStorage::EnumElements, méthode (objidl.h)
La méthode EnumElements récupère un pointeur vers un objet d’énumérateur qui peut être utilisé pour énumérer les objets de stockage et de flux 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 future ; doit être 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 l’ensemble 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 celle-ci 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érateur 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 autoriser 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 à refléter l’état actuel de l’objet de stockage.
Configuration requise
| 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 |