Método IStorage::EnumElements (objidl.h)
O método EnumElements recupera um ponteiro para um objeto enumerador que pode ser usado para enumerar os objetos de armazenamento e fluxo contidos nesse objeto de armazenamento.
Sintaxe
HRESULT EnumElements(
[in] DWORD reserved1,
[in] void *reserved2,
[in] DWORD reserved3,
[out] IEnumSTATSTG **ppenum
);
Parâmetros
[in] reserved1
Reservado para uso futuro; deve ser zero.
[in] reserved2
Reservado para uso futuro; deve ser NULL.
[in] reserved3
Reservado para uso futuro; deve ser zero.
[out] ppenum
Ponteiro para a variável de ponteiro IEnumSTATSTG* que recebe o ponteiro de interface para o novo objeto enumerador.
Retornar valor
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
| S_OK | O objeto enumerador foi retornado com êxito. |
| E_PENDING | Somente armazenamento assíncrono: parte ou todos os dados do elemento estão indisponíveis no momento. |
| STG_E_INSUFFICIENTMEMORY | O objeto enumerador não pôde ser criado devido à falta de memória. |
| STG_E_INVALIDPARAMETER | Um dos parâmetros não era válido. |
| STG_E_REVERTED | O objeto de armazenamento foi invalidado por uma operação de reverter acima dele na árvore de transações. |
Comentários
O objeto enumerador retornado por esse método implementa a interface IEnumSTATSTG , uma das interfaces de enumerador padrão que contêm os métodos Next, Reset, Clone e Skip . IEnumSTATSTG enumera os dados armazenados em uma matriz de estruturas STATSTG .
O objeto de armazenamento deve estar aberto no modo de leitura para permitir a enumeração de seus elementos.
O objeto enumerador tem permissão para enumerar os elementos em qualquer ordem. O objeto enumerador também tem permissão para tratar a enumeração como um instantâneo ou fazer com que a enumeração reflita o estado atual do objeto de armazenamento.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | objidl.h |
| Biblioteca | Uuid.lib |
| DLL | Ole32.dll |