Метод IFunctionInstance::OpenPropertyStore (functiondiscoveryapi.h)

[Функция обнаружения доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Открывает хранилище свойств для экземпляра функции. Хранилище свойств содержит метаданные об экземпляре функции, такие как его имя, значок, дата установки и другие сведения.

Синтаксис

HRESULT OpenPropertyStore(
  [in]  DWORD          dwStgAccess,
  [out] IPropertyStore **ppIPropertyStore
);

Параметры

[in] dwStgAccess

Режим доступа, назначаемый открытому потоку. Для этого метода поддерживаются следующие режимы доступа:

STGM_READ

STGM_READWRITE

STGM_WRITE

[out] ppIPropertyStore

Указатель на указатель интерфейса IPropertyStore .

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

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата	Описание
S_OK	Метод завершился успешно.
STG_E_ACCESSDENIED	Методу не удалось открыть хранилище свойств, доступного для записи, из-за того, что вызывающий объект имеет недостаточный доступ или поставщик обнаружения не разрешает доступ на запись в хранилище свойств.
E_INVALIDARG	Недопустимое значение dwStgAccess .
E_POINTER	PpIPropertyStore указывает на недопустимую память.
E_OUTOFMEMORY	Метод не может выделить память, необходимую для выполнения этой операции.

Комментарии

Одновременно можно открыть только одно хранилище свойств для каждого экземпляра функции. Если OpenPropertyStore вызывается дважды в одном экземпляре функции, оба указателя ppIPropertyStore будут указывать на одно и то же хранилище свойств. Кроме того, режим доступа (как указано в параметре dwStgAccess ) определяется последним вызовом OpenPropertyStore . Приложения должны вызывать Release , чтобы закрыть хранилище свойств перед открытием другого.

Возможно, OpenPropertyStore вернет хранилище свойств для удаленного устройства. В этом случае ключи свойств в хранилище будут пустыми. Такая ситуация может возникнуть, если devnode устройства был удален, но хранилище свойств, связанное с экземпляром функции устройства, по-прежнему доступно. Такая ситуация возникает редко.

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	functiondiscoveryapi.h
DLL	FunDisc.dll

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

IFunctionInstance