SHGetNameFromIDList 函数 （shobjidl_core.h）

检索 IDList 标识的项的显示名称。

Syntax

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 以释放内存。

要求