共用方式為

PSGetPropertyDescriptionListFromString 函式 (propsys.h)

  • 發行項

取得指定屬性清單的屬性描述清單介面實例。

語法

PSSTDAPI PSGetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

參數

[in] pszPropList

類型： LPCWSTR

以 Null 結尾的 Unicode 字串指標，識別屬性清單。 如需此參數格式的詳細資訊，請參閱 IPropertySystem：：GetPropertyDescriptionListFromString 。

[in] riid

類型： REFIID

所要求介面之介面標識碼的參考。

[out] ppv

類型： void**

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

傳回值

類型： PSSTDAPI

傳回下列其中一個值。

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

備註

此函式會呼叫 IPropertySystem：：GetPropertyDescriptionListFromString 的屬性子系統實作，以取得提供做為分號分隔屬性清單字元串的屬性集合。

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

如需屬性架構的詳細資訊，請參閱 屬性架構。

範例

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

IPropertyDescriptionList *pList;

HRESULT hr = PSGetPropertyDescriptionListFromString(L"prop:System.Title;System.Size",
                                                    IID_PPV_ARGS(&pList));
                                                    
if (SUCCEEDED(hr))
{
    // pList is now valid.
 
    pList->Release();
}

規格需求

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