Méthode IStorage ::EnumElements (objidl.h)

  • Article

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

Voir aussi

IEnumSTATSTG

IStorage - Implémentation de fichiers composés

STATSTG