Implementação de arquivo IEnumSTATPROPSTG-Compound
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
-
Obtém a próxima ou mais estruturas STATPROPSTG (o número é especificado pelo parâmetro celt ). Retorna S_OK se tiver êxito.
-
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.
-
Define o cursor como o início da enumeração. Se tiver êxito, retornará S_OK, caso contrário, retornará STG_E_INVALIDHANDLE.
-
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.
Tópicos relacionados