IAssocHandler：：GetIconLocation 方法 (shobjidl_core.h)

  • 项目

检索与应用程序关联的图标的位置。

语法

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

参数

[out] ppszPath

类型： LPWSTR*

此方法返回时，包含指向以 null 结尾的 Unicode 字符串的指针的地址，该字符串包含应用程序图标的路径。

[out] pIndex

类型： int*

此方法返回时，包含指向 ppszPath 中名为 的资源中图标的索引的指针。

返回值

类型： HRESULT

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

注解

如果找不到该图标，该函数将返回可执行文件的路径和图标索引为零。

出于性能原因，应用程序可以使用 Shell 映像缓存来检索图标，而不是直接从返回的路径加载图标。 路径和图标索引可以直接传递给 Shell_GetCachedImageIndex。 这样做的好处之一是，如果应用程序没有可用的图标，Shell 缓存可以提供默认图标。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)