IThumbnailProvider 接口 （thumbcache.h）

公开用于获取缩略图的方法，旨在实现缩略图处理程序。 实现此接口的对象还必须实现 IInitializeWithStream。

遗产

IThumbnailProvider 接口继承自 IUnknown 接口。 IThumbnailProvider 也有以下类型的成员：

方法

IThumbnailProvider 接口具有这些方法。

IThumbnailProvider：：GetThumbnail 获取缩略图和 alpha 类型。

言论

Shell 调用 IThumbnailProvider：：GetThumbnail 以获取要用作项表示形式的图像。

Microsoft Windows 中提供了照片缩略图的此接口实现，作为CLSID_PhotoThumbnailProvider提供。 使用提供的实现的应用程序必须使用 GUID {C7657C4A-9F68-40fa-A4DF-96BC08EB3551} 定义常量 CLSID 标识符。

// {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}
const CLSID CLSID_PhotoThumbnailProvider = {0xC7657C4A, 0x9F68, 0x40fa, {0xA4, 0xDF, 0x96, 0xBC, 0x08, 0xEB, 0x35, 0x51}} ;

初始化 实现此接口的对象还必须实现 IInitializeWithStream。 Shell 使用项流调用 IInitializeWithStream：：Initialize，IInitializeWithStream 是加载 IThumbnailProvider 实例时使用的唯一初始化接口（用于隔离目的）。 这是所有 IThumbnailCache 代码路径的 Windows 的主要代码路径。

当第三方请求处理程序而不使用 IThumbnailCache API 时，可以使用 IInitializeWithItem 或 IInitializeWithFile 初始化缩略图实现，但这并不常见。 如果实现 IInitializeWithItem，Shell 将使用项 IShellItem 表示形式调用 IInitializeWithItem：：Initialize。 如果实现 IInitializeWithFile，Shell 将使用文件的路径调用 IInitializeWithFile：：Initialize。

如果没有这些接口，则不调用 IThumbnailProvider。

客户端应用 如果要开发客户端应用，则应改用 IShellItemImageFactory。

Windows Vista IThumbnailProvider 是 Vista 的新增功能，取代了 IExtractImage。 Vista 仍支持 IExtractImage，但缺少返回图像类型（alpha 或不返回）的能力。

要求

要求	价值
最低支持的客户端	Windows Vista [仅限桌面应用]
支持的最低服务器	Windows Server 2008 [仅限桌面应用]
目标平台	窗户
标头	thumbcache.h