PSCreatePropertyStoreFromPropertySetStorage 函式 (propsys.h)

IPropertyStore 介面中包裝 IPropertySetStorage 介面。

語法

PSSTDAPI PSCreatePropertyStoreFromPropertySetStorage(
  [in]  IPropertySetStorage *ppss,
  [in]  DWORD               grfMode,
  [in]  REFIID              riid,
  [out] void                **ppv
);

參數

[in] ppss

類型: IPropertySetStorage*

IPropertySetStorage 介面的指標。

[in] grfMode

類型: DWORD

指定要強制執行的存取模式。 grfMode 應該符合用來開啟 IPropertySetStorage 的存取模式。 下列是有效值:

STGM_READ

呼叫 IPropertyStore::SetValue 會更新屬性的內部快取,並呼叫 IPropertyStore::Commit 呼叫適當的 IPropertySetStorage 方法來寫出變更的屬性。

STGM_WRITE

不支援。

STGM_READWRITE

不支援。

[in] riid

類型: REFIID

IID 的參考。

[out] ppv

類型: void**

當此函式傳回時,包含 riid中指定的介面指標。

傳回值

類型: HRESULT

如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

此函式會在 IPropertyStore 介面中包裝 IPropertySetStorage 介面。 grfModeSTGM_READ以外的任何值,會導致呼叫 IPropertyStore::SetValue 和 IPropertyStore::Commit 失敗,併產生STG_E_ACCESSDENIED。

規格需求

需求
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 propsys.h
程式庫 Propsys.lib
Dll Propsys.dll (6.0 版或更新版本)
可轉散發套件 Windows 桌面搜尋 (WDS) 3.0