PSGetPropertySystem 函式 (propsys.h)

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

語法

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

參數

[in] riid

類型： REFIID

所要求介面之 IID 的參考。

[out] ppv

類型： void**

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

傳回值

類型： PSSTDAPI

傳回下列其中一個值。

備註

您必須先使用 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();
}

需求