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 以釋放記憶體。