SHGetStockIconInfo 函数 (shellapi.h)

检索有关系统定义的 Shell 图标的信息。

语法

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

参数

siid

类型： SHSTOCKICONID

SHSTOCKICONID 枚举中的值之一，该值指定应检索的图标。

uFlags

类型： UINT

指定请求的信息的以下标志的零个或多个组合。

SHGSI_ICONLOCATION

SHSTOCKICONINFO 结构的 szPath 和 iIcon 成员以适合传递给 ExtractIcon 函数的格式接收所请求图标的路径和图标索引。 此标志的数值为零，因此无论其他标志如何，你始终都能获取图标位置。

SHGSI_ICON

SHSTOCKICONINFO 结构的 hIcon 成员接收指定图标的句柄。

SHGSI_SYSICONINDEX

SHSTOCKICONINFO 结构的 iSysImageImage 成员接收系统映像列表中指定图标的索引。

SHGSI_LINKOVERLAY

通过使 函数将链接覆盖添加到文件的图标来修改SHGSI_ICON值。

SHGSI_SELECTED

通过使函数将图标与系统突出显示颜色混合来修改SHGSI_ICON值。

SHGSI_LARGEICON

修改SHGSI_ICON值，方法是使函数检索由SM_CXICON和SM_CYICON系统指标指定的大型图标版本。

SHGSI_SMALLICON

修改SHGSI_ICON值，方法是使函数检索由SM_CXSMICON和SM_CYSMICON系统指标指定的小版本的图标。

SHGSI_SHELLICONSIZE

通过使函数检索 Shell 大小的图标而不是系统指标指定的大小来修改SHGSI_LARGEICON或SHGSI_SMALLICON值。

[in, out] psii

类型： SHSTOCKICONINFO*

指向 SHSTOCKICONINFO 结构的指针。 调用此函数时，需要将此结构的 cbSize 成员设置为 SHSTOCKICONINFO 结构的大小。 此函数返回时，包含指向 SHSTOCKICONINFO 结构的指针，该结构包含请求的信息。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

如果此函数在 psii 指向的 SHSTOCKICONINFO 结构的 hIcon 成员中返回图标句柄，则你负责在不再需要时使用 DestroyIcon 释放该图标。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shellapi.h
DLL	Shell32.dll
API 集	Windows 10版本 10.0.10240 中引入的 ext-ms-win-shell-shell32-l1-2-1 ()