Implementação de arquivo IEnumSTATPROPSTG-Compound
A implementação de arquivo composto da interface IEnumSTATPROPSTG é usada para enumerar propriedades, resultando em estruturas deSTATPROPSTG, 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 estruturasSTATPROPSTGque 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.
Observações
-
Obtém a próxima estruturas de STATPROPSTG (o número é especificado pelo parâmetro de celt). Retorna S_OK se bem-sucedido.
-
Ignora o número de elementos especificados em de celt . O próximo elemento a ser enumerado por meio de uma chamada para Next, em seguida, torna-se o elemento após os elementos ignorados. Retorna S_OK se elementos de de celt foram ignorados; retornará S_FALSE se menos de elementos de de 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 do 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