Implementação de arquivo IEnumSTATPROPSTG-Compound

  • Artigo

A implementação de arquivo composto da interface IEnumSTATPROPSTG é usada para enumerar propriedades, resultando em estruturas STATPROPSTG , que contêm dados de propriedade estatística. A implementação de IPropertyStorage gerencia os dados estatísticos e está associada a um objeto de armazenamento de arquivos composto atual.

O construtor na implementação COM de IEnumSTATPROPSTG cria uma classe que lê todo o conjunto de propriedades e cria uma matriz estática que pode ser compartilhada quando IEnumSTATPROPSTG::Clone é chamado.

Quando usar

Chame a implementação de arquivo composto de IEnumSTATPROPSTG para enumerar as estruturas STATPROPSTG que contêm dados sobre as propriedades dentro do conjunto de propriedades atual. Ao usar a implementação de arquivo composto das interfaces de armazenamento de propriedades, chame IPropertyStorage::Enum para retornar um ponteiro para IEnumSTATPROPSTG para gerenciar o objeto de armazenamento de propriedades e os elementos dentro dele.

Comentários

IEnumSTATPROPSTG::Next

Obtém a próxima ou mais estruturas STATPROPSTG (o número é especificado pelo parâmetro celt ). Retorna S_OK se tiver êxito.

IEnumSTATPROPSTG::Skip

Ignora o número de elementos especificados em celt. O próximo elemento a ser enumerado por meio de uma chamada para Next se torna o elemento após os elementos ignorados. Retorna S_OK se os elementos celt foram ignorados; retornará S_FALSE se menos elementos celt foram ignorados.

IEnumSTATPROPSTG::Reset

Define o cursor como o início da enumeração. Se tiver êxito, retornará S_OK, caso contrário, retornará STG_E_INVALIDHANDLE.

IEnumSTATPROPSTG::Clone

Usa o construtor para IEnumSTATPROPSTG para criar uma cópia da matriz. Como a classe que constrói a matriz estática realmente contém o objeto , essa função adiciona principalmente à contagem de referência.

STATPROPSTG

IPropertyStorage::Enum