Интерфейс IEnumSTATPROPSTG (propidlbase.h)

  • Статья

Интерфейс IEnumSTATPROPSTG выполняет итерацию по массиву структур STATPROPSTG . Структуры STATPROPSTG содержат статистические данные о свойствах в наборе свойств. IEnumSTATPROPSTG имеет те же методы, что и все интерфейсы перечислителя: Next, Skip, Reset и Clone.

Реализация определяет порядок перечисления свойств в наборе. Свойства, которые присутствуют при создании перечислителя и не удаляются во время перечисления, будут перечислены только один раз. Свойства, добавленные или удаленные во время выполнения перечисления, могут быть перечислены или не могут быть перечислены, но никогда не будут перечисляться более одного раза.

Зарезервированные идентификаторы свойств, свойства с идентификатором свойства 0 (словарь), 1 (индикатор кодовой страницы) или больше или равны 0x80000000 не перечисляются.

Перечисление неимплевого свойства не обязательно указывает, что свойство может быть успешно прочитано с помощью вызова IPropertyStorage::ReadMultiple. Это связано с тем, что затраты на производительность при проверке наличия косвенного потока или хранилища являются недопустимыми во время перечисления свойств.

Наследование

Интерфейс IEnumSTATPROPSTG наследуется от интерфейса IUnknown . IEnumSTATPROPSTG также имеет следующие типы элементов:

Методы

Интерфейс IEnumSTATPROPSTG содержит следующие методы.

 
IEnumSTATPROPSTG::Clone

Метод IEnumSTATPROPSTG::Clone создает перечислитель, содержащий то же состояние перечисления, что и текущий перечислитель структуры STATPROPSTG.
IEnumSTATPROPSTG::Next

Метод IEnumSTATPROPSTG::Next извлекает указанное количество структур STATPROPSTG, которые затем следуют в последовательности перечисления.
IEnumSTATPROPSTG::Reset

Метод IEnumSTATPROPSTG::Reset сбрасывает последовательность перечисления до начала массива структуры STATPROPSTG.
IEnumSTATPROPSTG::Skip

Метод IEnumSTATPROPSTG::Skip пропускает указанное количество структур STATPROPSTG в последовательности перечисления.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header propidlbase.h (включая Propidl.h)

См. также раздел

Пример EnumAll

IPropertyStorage::Enum