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 错误代码。