IPersistSerializedPropStorage::SetFlags 方法 (propsys.h)

在只读和读/写状态之间切换属性存储对象。

语法

HRESULT SetFlags(
  [in] PERSIST_SPROPSTORE_FLAGS flags
);

参数

[in] flags

类型: PERSIST_SPROPSTORE_FLAGS

flags 参数采用以下值之一来设置属性存储行为的选项:

FPSPS_DEFAULT (0x00000000)

Windows 7 及更高版本。 属性存储对象是可读/写的。

FPSPS_READONLY (0x00000001)

属性存储对象是只读的。

FPSPS_TREAT_NEW_VALUES_AS_DIRTY (0x00000002)

在 Windows 8 中引入。 通过 IPropertyStore::SetValue 方法添加到属性存储区的新属性值将导致 IPersistStream::IsDirty 方法返回S_OK。 如果未设置此标志,则向属性存储区添加新属性值不会影响 IPersistStream::IsDirty 返回的值。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

读/写是默认设置。 可以随时调用 IPersistSerializedPropStorage::SetFlags 来切换属性存储的只读和读/写状态。

在 Windows 7 之前的 Windows 版本中,调用方可以直接将文本零值分配给 flags 参数以设置读/写状态。 从 Windows 7 开始,应改用 FPSPS_DEFAULT 标志值。

要求

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