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

  • Artigo

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

Confira também

Ienumstatstg

IStorage – Implementação de arquivo composto

STATSTG