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


Метод IPropertyStoreFactory::GetPropertyStore (propsys.h)

Возвращает объект IPropertyStore , соответствующий предоставленным флагам.

Синтаксис

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

Параметры

[in] flags

Тип: GETPROPERTYSTOREFLAGS

Значения GETPROPERTYSTOREFLAGS , которые изменяют возвращаемое хранилище.

[in] pUnkFactory

Тип: IUnknown*

Необязательный элемент. Указатель на IUnknown объекта, реализующего ICreateObject. Если указан pUnkFactory , этот метод может создать экземпляр обработчика с помощью ICreateObject , а не CoCreateInstance, если он реализован. Причиной предоставления pUnkFactory обычно является создание обработчика в другом процессе. Однако для большинства пользователей достаточно передать значение NULL в этом параметре.

[in] riid

Тип: REFIID

Ссылка на ИДЕНТИФИКАТОР создаваемого объекта.

[out] ppv

Тип: void**

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

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

Тип: HRESULT

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

Комментарии

Рекомендуется использовать макрос IID_PPV_ARGS, определенный в Objbase.h, для упаковки параметров riid и ppv . Этот макрос предоставляет правильный КОД на основе интерфейса, на который указывает значение в ppv, что исключает возможность ошибки кода.

Требования

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