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


Метод IShellItem2::GetPropertyStoreWithCreateObject (shobjidl_core.h)

Использует указанный объект ICreateObject вместо CoCreateInstance для создания экземпляра обработчика свойств, связанного с элементом оболочки, для которого вызывается этот метод. Большинство вызывающих приложений не должны вызывать этот метод и могут вызывать IShellItem2::GetPropertyStore .

Синтаксис

HRESULT GetPropertyStoreWithCreateObject(
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  IUnknown              *punkCreateObject,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Параметры

[in] flags

Тип: GETPROPERTYSTOREFLAGS

Константы GETPROPERTYSTOREFLAGS , которые изменяют объект хранилища свойств.

[in] punkCreateObject

Тип: IUnknown*

Указатель на фабрику для создания с низким уровнем прав типа ICreateObject.

Метод CreateObject создает экземпляр COM-объекта. Реализация IShellItem2::GetPropertyStoreWithCreateObject использует CreateObject вместо CoCreateInstance для создания обработчика свойств, который является расширением оболочки для заданного типа файла. Обработчик свойств предоставляет множество важных свойств в хранилище свойств, возвращаемых этим методом.

Этот метод полезен только в том случае, если объект ICreateObject создается в отдельном процессе (как LOCALSERVER вместо INPROCSERVER), а также если этот другой процесс имеет более низкие права, чем процесс, вызывающий IShellItem2::GetPropertyStoreWithCreateObject.

[in] riid

Тип: REFIID

Ссылка на IID извлекаемого объекта.

[out] ppv

Тип: void**

При возврате этого метода содержит адрес запрошенного указателя интерфейса IPropertyStore .

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Примечание При вызове этого метода в хранилище свойств для файла этот файл сохраняется открытым в течение времени существования объекта IPropertyStore .
 

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)