IExtractIconA：：Extract 方法 (shlobj_core.h)

从指定位置提取图标图像。

语法

HRESULT Extract(
  [in]            PCSTR pszFile,
                  UINT  nIconIndex,
  [out, optional] HICON *phiconLarge,
  [out, optional] HICON *phiconSmall,
                  UINT  nIconSize
);

参数

[in] pszFile

类型： PCTSTR

指向以 null 结尾的字符串的指针，该字符串指定图标位置。

nIconIndex

类型： UINT

pszFile 指向的文件中图标的索引。

[out, optional] phiconLarge

类型： HICON*

指向 HICON 值的指针，该值接收大图标的句柄。 此参数可以为 NULL。

[out, optional] phiconSmall

类型： HICON*

指向 HICON 值的指针，该值接收小图标的句柄。 此参数可以为 NULL。

nIconSize

类型： UINT

图标的所需大小（以像素为单位）。 低字包含大图标的大小，高字包含小图标的大小。 指定的大小可以是宽度或高度。 图标的宽度始终等于其高度。

返回值

类型： HRESULT

如果函数提取了图标，则返回S_OK;如果调用的应用程序应提取图标，则返回S_FALSE。

注解

图标位置和索引与 IExtractIcon：：GetIconLocation 方法返回的值相同。 如果 IExtractIcon：：Extract 函数返回S_FALSE，则这些值必须指定一个图标文件名和索引，该图标文件名和索引构成 对 ExtractIcon 的调用的法律参数。 如果 IExtractIcon：：Extract 不返回S_FALSE，则不应假设 pszFile 和 nIconIndex 参数的含义。

要求

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

另请参阅

IExtractIcon