IShellItem：：GetDisplayName 方法 (shobjidl_core.h)

  • 项目

获取 IShellItem 对象的显示名称。

语法

HRESULT GetDisplayName(
  [in]  SIGDN  sigdnName,
  [out] LPWSTR *ppszName
);

参数

[in] sigdnName

类型： SIGDN

指示名称外观的 SIGDN 值之一。

[out] ppszName

类型： LPWSTR*

一个 值，当此函数成功返回时，接收指向检索到的显示名称的指针的地址。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

当不再需要 ppszName 指向的字符串时，调用方有责任释放该字符串。 在 *ppszName 上调用 CoTaskMemFree 以释放内存。

要求

要求 值
最低受支持的客户端 具有 SP1 的 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shlguid.h)
DLL Shell32.dll (版本 5.00 或更高版本)

另请参阅

IShellFolder

IShellItem