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 可能会返回已删除设备的属性存储。 在这种情况下，存储中的属性键将为空。 如果删除了设备的 开发节点 ，但仍可访问与设备函数实例关联的属性存储，则可能会出现这种情况。 这种情况很少发生。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 functiondiscoveryapi.h
DLL FunDisc.dll

请参阅

IFunctionInstance