IExtractImage interface

Exposes methods that request a thumbnail image from a Shell folder.


The IExtractImage interface has these methods.

Method Description
IExtractImage::Extract Requests an image from an object, such as an item in a Shell folder.
IExtractImage::GetLocation Gets a path to the image that is to be extracted.


There are two steps in the process: First, use GetLocation to request the path description of an image and specify how the image should be rendered. Then, call Extract to extract the image.

If the object is free-threaded it must also expose an IRunnableTask interface so it can be stopped and started as needed. This feature can be particularly useful when extraction may be slow.

Implement IExtractImage if your namespace extension needs to provide thumbnail images to be displayed in a Shellview.

Use IExtractImage if you are implementing a view of namespace objects, and want to display thumbnail images. You can use a Shell folder's IShellFolder::GetUIObjectOf method to bind to its IExtractImage interface.


Windows version Windows 2000 Professional, Windows XP [desktop apps only] Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)