共用方式為

PSGetPropertySystem 函式 (propsys.h)

  • 發行項

取得實作 IPropertySystem之子系統物件的實例。

語法

PSSTDAPI PSGetPropertySystem(
  [in]  REFIID riid,
  [out] void   **ppv
);

參數

[in] riid

類型： REFIID

所要求介面之 IID 的參考。

[out] ppv

類型： void**

當此函式傳回時，包含 riid中要求的介面指標。 這通常是 IPropertySystem。

傳回值

類型： PSSTDAPI

傳回下列其中一個值。

傳回碼 描述
S_OK
 已取得 介面。
E_INVALIDARG
 ppv參數為Null。

備註

您必須先使用 CoInitialize 或 OleInitialize 初始化元件物件模型 (COM) ，才能呼叫 PSGetPropertySystem。 COM 必須在此物件的存留期內保持初始化狀態。 屬性系統物件會匯總自由執行緒封送處理器，而且是安全線程。

我們建議您使用 Objbase.h 中定義的IID_PPV_ARGS宏來封裝 riid 和 ppv 參數。 這個宏會根據 ppv中值所指向的介面提供正確的 IID，這可消除編碼錯誤的可能性。

範例

下列範例要包含在較大的程式中，示範如何使用 PSGetPropertySystem。

IPropertySystem *pSystem;

HRESULT hr = PSGetPropertySystem(IID_PPV_ARGS(&pSystem));

if (SUCCEEDED(hr))
{
    // pSystem is now valid.
 
    pSystem->Release();
}

需求

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