IMMDevice：：OpenPropertyStore 方法 (mmdeviceapi.h)

  • 项目

OpenPropertyStore 方法检索设备属性存储的接口。

语法

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

parameters

[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
标头 mmdeviceapi.h

另请参阅

IMMDevice 接口