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