extractAssociatedIconExA 函数 (shellapi.h)

[ExtractAssociatedIconEx 可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]

获取作为资源存储在文件中的图标或存储在文件的关联可执行文件中的图标的句柄。 它通过在从可执行文件中提取图标时检索图标的 ID 来扩展 ExtractAssociatedIcon 函数。

语法

HICON ExtractAssociatedIconExA(
  [in]      HINSTANCE hInst,
  [in, out] LPSTR     pszIconPath,
  [in, out] WORD      *piIconIndex,
  [in, out] WORD      *piIconId
);

参数

[in] hInst

类型： HINSTANCE

要从中提取图标的模块的句柄。

[in, out] pszIconPath

类型： LPTSTR

指向字符串的指针，该字符串在输入时指定包含图标的文件的完整路径和文件名。 函数从该文件或与该文件关联的可执行文件中提取图标句柄。

当此函数返回时，如果图标句柄是从可执行文件 (此参数直接指向的可执行文件或关联的可执行文件) 函数会将该可执行文件的完整路径和文件名存储在此参数指向的缓冲区中。

[in, out] piIconIndex

类型： LPWORD

指向 WORD 值的指针，该值在输入时指定要获取其句柄的图标的索引。

当函数返回时，如果图标句柄是从可执行文件 (lpIconPath 指向的可执行文件或) 关联的可执行文件中获取的，则此值指向该文件中图标的索引。

[in, out] piIconId

类型： LPWORD

指向 WORD 值的指针，该值在输入时指定要获取其句柄的图标的 ID。

当函数返回时，如果图标句柄是从可执行文件 (lpIconPath 指向的可执行文件或) 关联的可执行文件中获取的，则此值指向该文件中图标的 ID。

返回值

类型： HICON

如果成功，则返回图标的句柄，否则返回 NULL。

注解

当不再需要时，必须通过调用 DestroyIcon 释放此函数返回的图标句柄。

注意

shellapi.h 标头将 ExtractAssociatedIconEx 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	shellapi.h
Library	Shell32.lib
DLL	Shell32.dll (5.0 或更高版本)

另请参阅

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx