IExtractImage interface (shobjidl_core.h)

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

Inheritance

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

Methods

The IExtractImage interface has these methods.

 
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.

Remarks

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.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)