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,则不应假设 pszFilenIconIndex 参数的含义。

要求

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

另请参阅

IExtractIcon