IThumbnailProvider インターフェイス (thumbcache.h)

サムネイル画像を取得するためのメソッドを公開し、サムネイル ハンドラー用に実装することを目的としています。 このインターフェイスを実装するオブジェクトは、IInitializeWithStream 実装する必要もあります。

継承

IThumbnailProvider インターフェイスは、IUnknown インターフェイスから継承します。 IThumbnailProvider には、次の種類のメンバーもあります。

メソッド

IThumbnailProvider インターフェイスには、次のメソッドがあります。

IThumbnailProvider::GetThumbnail サムネイル画像とアルファの種類を取得します。

備考

シェルは IThumbnailProvider::GetThumbnail 呼び出して、アイテムの表現として使用するイメージを取得します。

写真サムネイル用のこのインターフェイスの実装は、CLSID_PhotoThumbnailProviderとして Microsoft Windows で提供されます。 指定された実装を使用するアプリケーションでは、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 実装する必要もあります。 シェルは、項目のストリーム IInitializeWithStream::Initialize を呼び出します。IInitializeWithStream は、IThumbnailProvider インスタンスがアウトプロセスで読み込まれるときに使用される唯一の初期化インターフェイスです (分離のために)。 これは、すべての IThumbnailCache コード パスの Windows のプライマリ コード パスです。

IThumbnailCache API を使用せずにハンドラーがサード パーティから要求された場合、サムネイルの実装を IInitializeWithItem または IInitializeWithFile で初期化することはできますが、これは一般的ではありません。 IInitializeWithItem 実装した場合、シェルは IInitializeWithItem::Initialize を IShellItem 表現で 呼び出します。 IInitializeWithFile 実装すると、シェルはファイルのパス IInitializeWithFile::Initialize を呼び出します。

これらのインターフェイスが存在しない場合、IThumbnailProvider は呼び出されません。

クライアント アプリ クライアント アプリを開発する場合は、代わりに IShellItemImageFactory 使用する必要があります。

Windows Vista IThumbnailProvider は Vista の新機能であり、IExtractImage 置き換えられます。 Vista は引き続き IExtractImage をサポートしていますが、イメージの種類 (アルファかどうか) を返す機能がありません。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	thumbcache.h