共用方式為


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