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 |