Поделиться через

Реализация файла IEnumSTATPROPSTG-Compound

  • Статья

Реализация составного файла интерфейса IEnumSTATPROPSTG используется для перечисления свойств, в результате чего возникают структуры STATPROPSTG , содержащие статистические данные свойств. Реализация IPropertyStorage управляет статистическими данными и связана с текущим объектом хранилища составных файлов.

Конструктор в реализации COM IEnumSTATPROPSTG создает класс, который считывает весь набор свойств, и создает статический массив, который можно совместно использовать при вызове IEnumSTATPROPSTG::Clone .

Назначение

Вызовите реализацию составного файла IEnumSTATPROPSTG для перечисления структур STATPROPSTG , содержащих данные о свойствах в текущем наборе свойств. При использовании реализации составного файла интерфейсов хранилища свойств вызовите метод IPropertyStorage::Enum , чтобы вернуть указатель на IEnumSTATPROPSTG для управления объектом хранилища свойств и элементами в нем.

Комментарии

IEnumSTATPROPSTG::Next

Возвращает следующую одну или несколько структур STATPROPSTG (число задается параметром celt ). В случае успешного выполнения возвращает S_OK.

IEnumSTATPROPSTG::Skip

Пропускает количество элементов, указанных в celt. Следующий элемент, перечисляемый с помощью вызова Next, затем становится элементом после пропущенных элементов. Возвращает S_OK, если элементы celt были пропущены; возвращает S_FALSE, если пропущено меньше элементов celt .

IEnumSTATPROPSTG::Reset

Устанавливает курсор в начало перечисления. В случае успешного выполнения возвращается S_OK, в противном случае возвращается STG_E_INVALIDHANDLE.

IEnumSTATPROPSTG::Clone

Использует конструктор для IEnumSTATPROPSTG для создания копии массива. Так как класс, который создает статический массив, фактически содержит объект , эта функция в основном добавляет к счетчику ссылок.

STATPROPSTG

IPropertyStorage::Enum