IShellImageData::NextFrame method (shimgdata.h)

  • Article

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