Interface IEnumSTATPROPSTG (propidlbase.h)

A interface IEnumSTATPROPSTG itera por meio de uma matriz de estruturas STATPROPSTG . As estruturas STATPROPSTG contêm dados estatísticos sobre propriedades em um conjunto de propriedades. IEnumSTATPROPSTG tem os mesmos métodos que todas as interfaces de enumerador: Next, Skip, Reset e Clone.

A implementação define a ordem na qual as propriedades no conjunto são enumeradas. As propriedades presentes quando o enumerador é criado e não são removidas durante a enumeração serão enumeradas apenas uma vez. As propriedades adicionadas ou excluídas enquanto a enumeração estiver em andamento podem ou não ser enumeradas, mas nunca serão enumeradas mais de uma vez.

Identificadores de propriedade reservada, propriedades com uma ID de propriedade igual a 0 (dicionário), 1 (indicador de página de código) ou maior ou igual a 0x80000000 não são enumeradas.

A enumeração de uma propriedade não simplificada não indica necessariamente que a propriedade pode ser lida com êxito por meio de uma chamada para IPropertyStorage::ReadMultiple. Isso ocorre porque a sobrecarga de desempenho da verificação da existência do fluxo indireto ou do armazenamento é proibitiva durante a enumeração de propriedade.

Herança

A interface IEnumSTATPROPSTG herda da interface IUnknown . IEnumSTATPROPSTG também tem estes tipos de membros:

Métodos

A interface IEnumSTATPROPSTG tem esses métodos.

IEnumSTATPROPSTG::Clone O método IEnumSTATPROPSTG::Clone cria um enumerador que contém o mesmo estado de enumeração que o enumerador de estrutura STATPROPSTG atual.
IEnumSTATPROPSTG::Next O método IEnumSTATPROPSTG::Next recupera um número especificado de estruturas STATPROPSTG, que seguem posteriormente na sequência de enumeração.
IEnumSTATPROPSTG::Reset O método IEnumSTATPROPSTG::Reset redefine a sequência de enumeração para o início da matriz de estrutura STATPROPSTG.
IEnumSTATPROPSTG::Skip O método IEnumSTATPROPSTG::Skip ignora o número especificado de estruturas STATPROPSTG na sequência de enumeração.

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	propidlbase.h (inclua Propidl.h)

Confira também

Exemplo de EnumAll

IPropertyStorage::Enum