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 |