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

Возвращает объект IPropertyStore , заданный набором ключей свойств. Это обеспечивает альтернативный, возможно, более быстрый метод получения объекта IPropertyStore по сравнению с вызовом IPropertyStoreFactory::GetPropertyStore.

Синтаксис

HRESULT GetPropertyStoreForKeys(
  [in]  const PROPERTYKEY     *rgKeys,
  [in]  UINT                  cKeys,
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Параметры

[in] rgKeys

Тип: const PROPERTYKEY*

Указатель на массив структур PROPERTYKEY .

[in] cKeys

Тип: UINT

Количество структур PROPERTYKEY в массиве, на который указывает rgKeys.

[in] flags

Тип: GETPROPERTYSTOREFLAGS

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

[in] riid

Тип: REFIID

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

[out] ppv

Тип: void**

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

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

Тип: HRESULT

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

Комментарии

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

Требования

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