SHParseDisplayName 函式 (shlobj_core.h)
將Shell命名空間對象的顯示名稱轉譯為專案識別碼清單，並傳回物件的屬性。 此函式是將字串轉換成專案標識符清單指標的慣用方法， (PIDL) 。
語法
SHSTDAPI SHParseDisplayName(
[in] PCWSTR pszName,
[in, optional] IBindCtx *pbc,
[out] PIDLIST_ABSOLUTE *ppidl,
[in] SFGAOF sfgaoIn,
[out, optional] SFGAOF *psfgaoOut
);
參數
[in] pszName
類型： LPCWSTR
零終止寬字串的指標，其中包含要剖析的顯示名稱。
[in, optional] pbc
類型： IBindCtx*
控制剖析作業的系結內容。 此參數通常設定為 NULL。
[out] ppidl
類型： PIDLIST_ABSOLUTE*
ITEMIDLIST 類型的變數的指標位址，該變數會接收物件的專案標識碼清單。 如果發生錯誤，則此參數會設定為 NULL。
[in] sfgaoIn
類型： SFGAOF
ULONG 值，指定要查詢的屬性。 若要查詢一或多個屬性，請使用代表感興趣屬性的旗標初始化此參數。 如需可用的 SFGAO 旗標清單，請參閱 SFGAO。
[out, optional] psfgaoOut
類型： SFGAOF*
ULONG 的指標。 傳回時，會設定物件且 在 sfgaoIn 中要求的這些屬性為 true。 對象的屬性旗標可以是零或 SFGAO 旗標的組合。 如需可用的 SFGAO 旗標清單，請參閱 SFGAO。
傳回值
類型： HRESULT
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
您應該從背景線程呼叫此函式。 無法這麼做可能會導致 UI 停止回應。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | shlobj_core.h (包含 Shlobj.h) |
| 程式庫 | Shell32.lib |
| Dll | Shell32.dll (6.0 版或更新版本) |