SHCreateFileExtractIconA 函数 (shlobj_core.h)

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

为文件系统对象创建默认 的 IExtractIcon 处理程序。 显示文件系统对象的命名空间扩展通常使用此函数。 扩展和文件属性派生简单图标提取程序所需的所有内容。

语法

SHSTDAPI SHCreateFileExtractIconA(
  [in] LPCSTR pszFile,
  [in] DWORD  dwFileAttributes,
  [in] REFIID riid,
       void   **ppv
);

参数

[in] pszFile

类型: LPCTSTR

指向以 null 结尾的字符串的指针,该字符串指定文件系统对象。 缓冲区的长度不得超过 MAX_PATH 个字符。

[in] dwFileAttributes

类型:DWORD

指定对象类型的 Winnt.h) 中定义的一个或多个文件属性标志 (FILE_ATTRIBUTE_* 值的组合。

[in] riid

类型: REFIID

对要创建的图标提取程序接口的所需接口 ID 的引用。 这必须是IID_IExtractIconA或IID_IExtractIconW。

ppv

类型: void**

当此函数返回时,包含 riid 中请求的接口指针。 这通常是 IExtractIcon

返回值

类型: HRESULT

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

要求

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