IThumbnailProvider interface

Applies to: desktop apps only

Exposes a method for getting a thumbnail image.

Members

The IThumbnailProvider interface inherits from the IUnknown interface. IThumbnailProvider also has these types of members:

• Methods

Methods

The IThumbnailProvider interface has these methods.

Remarks

The Shell calls IThumbnailProvider::GetThumbnail to obtain an image to use as a representation of the item.

An implementation of this interface for photo thumbnails is supplied in Microsoft Windows as CLSID_PhotoThumbnailProvider. Applications that use the supplied implementation must define a constant CLSID identifier using the GUID {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}.

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

The object that implements this interface must also implement one of the following interfaces.

• IInitializeWithStream. If present, the Shell calls IInitializeWithStream::Initialize with the stream of the item. Thumbnail extractors for file system items should implement this whenever possible.
• IInitializeWithItem. If present, the Shell calls IInitializeWithItem::Initialize with the IShellItem representation of the item.
• IInitializeWithFile. If present, the Shell calls IInitializeWithFile::Initialize with the path of the file.

If none of these interfaces is present, IThumbnailProvider is not called.

Requirements

Send comments about this topic to Microsoft

Build date: 3/7/2012