Método IStorage::EnumElements (objidl.h)
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 |