Compartir a través de

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

  • Artículo

El método EnumElements recupera un puntero a un objeto enumerador que se puede usar para enumerar los objetos de almacenamiento y secuencia contenidos en este objeto de almacenamiento.

Sintaxis

HRESULT EnumElements(
  [in]  DWORD        reserved1,
  [in]  void         *reserved2,
  [in]  DWORD        reserved3,
  [out] IEnumSTATSTG **ppenum
);

Parámetros

[in] reserved1

Reservado para uso futuro; debe ser cero.

[in] reserved2

Reservado para uso futuro; debe ser NULL.

[in] reserved3

Reservado para uso futuro; debe ser cero.

[out] ppenum

Puntero a la variable de puntero IEnumSTATSTG* que recibe el puntero de interfaz al nuevo objeto enumerador.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK El objeto enumerador se devolvió correctamente.
E_PENDING Solo almacenamiento asincrónico: parte o todos los datos del elemento no están disponibles actualmente.
STG_E_INSUFFICIENTMEMORY No se pudo crear el objeto enumerador debido a la falta de memoria.
STG_E_INVALIDPARAMETER Uno de los parámetros no era válido.
STG_E_REVERTED El objeto de almacenamiento se ha invalidado mediante una operación de reversión encima de él en el árbol de transacciones.

Comentarios

El objeto enumerador devuelto por este método implementa la interfaz IEnumSTATSTG , una de las interfaces del enumerador estándar que contienen los métodos Next, Reset, Clone y Skip . IEnumSTATSTG enumera los datos almacenados en una matriz de estructuras STATSTG .

El objeto de almacenamiento debe estar abierto en modo de lectura para permitir la enumeración de sus elementos.

El objeto enumerador puede enumerar los elementos en cualquier orden. El objeto enumerador también puede tratar la enumeración como una instantánea o para que la enumeración refleje el estado actual del objeto de almacenamiento.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado objidl.h
Library Uuid.lib
Archivo DLL Ole32.dll

Consulte también

IEnumSTATSTG

IStorage: implementación de archivos compuestos

STATSTG