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 或更高版本) |