Метод IMMDevice::OpenPropertyStore (mmdeviceapi.h)

  • Статья

Метод OpenPropertyStore извлекает интерфейс в хранилище свойств устройства.

Синтаксис

HRESULT OpenPropertyStore(
  [in]  DWORD          stgmAccess,
  [out] IPropertyStore **ppProperties
);

Параметры

[in] stgmAccess

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

STGM_READ

STGM_WRITE

STGM_READWRITE

Метод позволяет клиенту, работающему от имени администратора, открывать хранилище только для чтения, только для записи или для чтения и записи. Клиент, работающий не от имени администратора, ограничен доступом только для чтения. Дополнительные сведения о константах STGM см. в документации по Windows SDK.

[out] ppProperties

Указатель на переменную указателя, в которую метод записывает адрес интерфейса IPropertyStore хранилища свойств устройства. С помощью этого метода вызывающий объект получает подсчитываемую ссылку на интерфейс . Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса. Если вызов OpenPropertyStore завершается ошибкой, *ppProperties имеет значение NULL. Дополнительные сведения об IPropertyStore см. в документации по windows SDK.

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

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

Код возврата Описание
E_INVALIDARG
 Параметр stgmAccess не является допустимым режимом доступа.
E_POINTER
 Параметр ppProperties имеет значение NULL.
E_OUTOFMEMORY
 Недостаточно памяти.

Комментарии

Как правило, свойства в хранилище свойств устройства доступны только для чтения для клиентов, которые не выполняют административные, системные или служебные функции.

Примеры кода, вызывающие метод OpenPropertyStore , см. в следующих разделах:

Требования

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

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

Интерфейс IMMDevice