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) |