PSCreateAdapterFromPropertyStore 函式 (propsys.h)
從 IPropertyStore 建立配接器。
語法
PSSTDAPI PSCreateAdapterFromPropertyStore(
[in] IPropertyStore *pps,
[in] REFIID riid,
[out] void **ppv
);
參數
[in] pps
類型： IPropertyStore*
代表屬性存放區的 IPropertyStore 物件的指標。
[in] riid
類型： REFIID
IID 的參考。
[out] ppv
類型： void**
當此函式傳回時，包含 riid中要求的介面指標。
傳回值
類型： HRESULT
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
配接器物件會實作 IPropertySetStorage、 IPropertyStore、 IPropertyStoreCapabilities 和 IObjectProvider。
如果您需要實作 IPropertyStore 的物件與需要 IPropertySetStorage 介面的 API，請使用此函式。 建立的物件也適用於想要支援使用 IPropertySetStorage 系結至命名空間專案的命名空間延伸模組。 應用程式一次只能從一個線程呼叫這個物件。
此函式所建立的配接器屬性存放區會保留來源 IPropertyStore 介面的參考。 因此，每當呼叫此函式之後方便時，呼叫應用程式就可以釋放其來源 IPropertyStore 的參考。
適配卡屬性存放區會視需要呼叫 IPropertyStore 介面上的方法。 因此，如果呼叫的應用程式正在將值寫入存放區，它應該只在其中一個介面上呼叫 IPropertyStore：：Commit 方法。
範例
下列範例要包含在較大的程式中，示範如何使用 PSCreateAdapterFromPropertyStore，以使用配接器屬性存放區將 IPropertyStore 介面轉換成 IPropertySetStorage 介面。
// IPropertyStore *ppropstore;
// Assume variable ppropstore is initialized and valid
IPropertySetStorage *pSetStorage;
HRESULT hr = PSCreateadapterFromPropertyStore(ppropstore, IID_PPV_ARGS(&pSetStorage));
if (SUCCEEDED(hr))
{
// pSetStorage is now valid and can be used to access the data in ppropstore.
pSetStorage->Release();
}
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 SP1 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | propsys.h |
| 程式庫 | Propsys.lib |
| Dll | Propsys.dll (6.0 版或更新版本) |
| 可轉散發套件 | Windows 桌面搜尋 (WDS) 3.0 |