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) |