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 |