IPropertySystem：：GetPropertyDescriptionListFromString 方法 (propsys.h)
取得實作 IPropertyDescriptionList 之子系統對象的實例，以根據提供的字串取得已排序的屬性描述集合。
語法
HRESULT GetPropertyDescriptionListFromString(
[in] LPCWSTR pszPropList,
[in] REFIID riid,
[out] void **ppv
);
參數
[in] pszPropList
類型： LPCWSTR
識別屬性清單之字串的指標。
[in] riid
類型： REFIID
所需 IID 的參考。
[out] ppv
類型： void**
IPropertyDescriptionList 介面指標的位址。
傳回值
類型： HRESULT
傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
表示已取得介面。 |
|
表示 ppv 為 NULL。 |
備註
屬性描述清單字串 (“proplist”) 語法是由標準屬性名稱序列所組成，具有與每個屬性名稱相關聯的旗標。 字串開頭為 “prop：”。 語法看起來像這樣： prop:[flags]propertyname[endflags];
旗標是選擇性的，而且可以是下列任一項。 注意：這些旗標會轉譯為 PROPDESC_VIEW_FLAGS 列舉。
| 旗標 | 意義 |
|---|---|
| - | 以反向順序排序 (PDVF_REVERSESORT) 。 |
| 0 | 預設會在主要和次要清單中顯示 (PDVF_SHOWBYDEFAULT |PDVF_SHOWINPRIMARYLIST |PDVF_SHOWINSECONDARYLIST) 。 |
| 1 | 在主要和次要清單中顯示 (PDVF_SHOWINPRIMARYLIST |PDVF_SHOWINSECONDARYLIST) 。 |
| 2 | 顯示在次要清單中 (PDVF_SHOWINSECONDARYLIST) 。 |
| ^ | 開始新的群組 (PDVF_BEGINNEWGROUP) 。 |
| / | 靠右對齊 (PDVF_RIGHTALIGN) 。 |
| * | 如果值不存在，請隱藏。 |
| | | 置中對齊。 (PDVF_CENTERALIGN) 。 |
| ~ | 隱藏標籤。 (PDVF_HIDELABEL) 。 |
| # | 填滿區域。 (PDVF_FILLAREA) 。 |
| ? | 如果屬性處理程式不支援，請隱藏 (PDVF_HIDEIFUNSUPPORTED) 。 |
| < | 剖析為連結 (PDVF_PARSEASLINK) 。 |
| & | 顯示為整個連結 (PDVF_SHOWASWHOLELINK) 。 |
從 dbfolder 和 file 資料夾檢視方塊：
| 0 | 顯示為 defview 中的數據行、資料行選擇器選單，以及資料行選擇器對話方塊。 |
| 1 | 顯示在數據列選擇器功能表和對話框中。 |
| 2 | 顯示在數據列選擇器對話框中。 |
| NULL | 包含在搜尋結果中，但隱藏在UI中。 |
結尾旗標也是選擇性的，而且可以是下列各項：
| EndFlag | 意義 |
|---|---|
| ] | 用於延伸磚檢視) 的結束數據行 (。 |
建議您使用 objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riid 和 ppv 參數。 此宏會根據 ppv 中值所指向的介面提供正確的 IID，消除編碼錯誤的可能性。
如需屬性架構的詳細資訊，請參閱 屬性架構。
規格需求
| 最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 SP1 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | propsys.h |
| Dll | Propsys.dll (5.0 版或更新版本) |
| 可轉散發套件 | Windows 桌面搜尋 (WDS) 3.0 |