SHGetNameFromIDList 函式 （shobjidl_core.h）

擷取其 IDList 所識別項目的顯示名稱。

語法

SHSTDAPI SHGetNameFromIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  SIGDN             sigdnName,
  [out] PWSTR             *ppszName
);

參數

[in] pidl

類型： PCIDLIST_ABSOLUTE

識別專案的 PIDL。

[in] sigdnName

類型： SIGDN

SIGDN 列舉中的值，指定要擷取的顯示名稱類型。

[out] ppszName

類型： PWSTR*

當此函式成功傳回時，會接收擷取顯示名稱指標的位址的值。

返回值

類型：HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

呼叫端有責任在不再需要 ppszName 指向的字串時釋放它。 在 *ppszName 上呼叫 CoTaskMemFree 以釋放記憶體。

需求