SHGetStockIconInfo 函数 （shellapi.h）

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

Syntax

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

通过使函数检索由SM_CXICON和SM_CYICON系统指标指定的大型图标版本来修改SHGSI_ICON值。

SHGSI_SMALLICON

通过使函数检索由SM_CXSMICON和SM_CYSMICON系统指标指定的小版本的图标来修改SHGSI_ICON值。

SHGSI_SHELLICONSIZE

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

[in, out] psii

类型： SHSTOCKICONINFO*

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

返回值

类型：HRESULT

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

注解

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

要求