IPropertySetStorage：：Open 方法 (propidl.h)

项目
03/01/2024

Open 方法打开属性集存储对象中包含的属性集。

语法

HRESULT Open(
  [in]  REFFMTID         rfmtid,
  [in]  DWORD            grfMode,
  [out] IPropertyStorage **ppprstg
);

参数

[in] rfmtid

要打开的属性集 (FMTID) 的格式标识符。有关平台 SDK 中已知和预定义的 FMTID 的详细信息，请参阅预定义的属性集格式标识符。

[in] grfMode

打开新创建的属性集的访问模式。这些标志取自 STGM 常量。以下“备注”部分介绍了可能使用的标志及其在此方法上下文中的含义。

[out] ppprstg

指向 IPropertyStorage 指针变量的指针，该变量接收指向请求的属性存储子对象的接口指针。

返回值

此方法支持E_UNEXPECTED的标准返回值，此外还支持以下各项：

注解

参数 grfMode 中指定了打开属性集的模式。这些标志取自 STGM 常量，但对于此方法，法律值及其含义如下所示 (只有这些标志值的某些组合是合法的) 。

值	含义
STGM_DIRECT	打开属性集，无需额外的事务嵌套级别。如果未) 指定STGM_DIRECT或STGM_TRANSACTED，则这是行为的默认 (。
STGM_TRANSACTED	打开属性集，该属性集具有额外的事务嵌套级别， (超出事务（如果有）的属性集，该属性集将存储对象) 。事务处理模式仅适用于非简单属性集。必须先通过调用 IPropertyStorage：：Commit 提交属性集中的更改，然后才能对此属性集存储上的事务可见。
STGM_READ	打开具有读取访问权限的属性集。属性集存储需要读取权限。
STGM_WRITE	打开具有写入访问权限的属性集。并非所有 IPropertyStorage 的实现都支持此模式。
STGM_READWRITE	打开具有读取和写入访问权限的属性集。请注意，此标志不是STGM_READ和STGM_WRITE值的二进制 OR。
STGM_SHARE_DENY_NONE	从此属性集存储中随后打开的属性集时，不会拒绝读取或写入访问。 (并非在所有实现中都可用。)
STGM_SHARE_DENY_READ	从此属性集存储中随后打开的属性集将被拒绝读取访问。并非在所有实现中都可用。
STGM_SHARE_DENY_WRITE	来自此属性集存储的属性集的后续打开将被拒绝写入访问。此值通常在事务处理模式下使用，以防止创建由多个用户打开的对象的不必要副本。也就是说，如果指定了STGM_TRANSACTED，但未指定此值，则无论是否有后续打开，都进行快照。因此，可以通过指定此值来提高性能。并非在所有实现中都可用。
STGM_SHARE_EXCLUSIVE	无法从此属性集存储中随后打开属性集。请注意，此值不是STGM_SHARE_DENY_READ和STGM_SHARE_DENY_WRITE元素的简单二进制 OR。

此方法受简单属性集的基础 IStorage：：OpenStream (的约束) 或 IStorage：：OpenStorage () 非简单属性集的约束。有关简单和非简单属性集的详细信息，请参阅属性集的存储和Stream对象。例如，使用 IPropertySetStorage-Compound File Implementation 时，必须将 grfMode 参数中的STGM_SHARE_EXCLUSIVE指定为 IPropertySetStorage：：Open。相反，如果使用 IPropertySetStorage-独立实现， 则 IPropertySetStorage：：Open 受适用于调用方指定的 IStorage 的约束。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	Windows
标头	propidl.h (包括 Objbase.h)
Library	Uuid.lib
DLL	Ole32.dll