IShellImageData::NextFrame method (shimgdata.h)

Switches to the next frame of an animated image.

Syntax

HRESULT NextFrame();

Return value

Type: HRESULT

Returns S_OK if successful or an error value otherwise, including the following:

Return code Description
E_FAIL
The current frame cannot be retrieved.
S_FALSE
The image is not animated, the image has not yet been decoded, or a limit on the number of times to loop the animation has been reached.
E_PENDING
The next frame is not yet available.
E_NOMOREDATA
No further data is available.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shimgdata.h
DLL Shell32.dll