Partilhar via

IENumManagerFrames::Next method

  • Artigo

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

Returns the next HWND in the list.

Syntax

HRESULT Next(
  [in]                                            unsigned long celt,
  [out, size_is(celt), length_is(* pceltFetched)] HWND ppWindows,
  [out]                                           unsigned long pceltFetched
);

Parameters

  • celt [in]
    The number of HWNDSs to fetch. Currently the method only accepts “1”

  • ppWindows [out]
    Contains an array of the IEFrame HWNDs

  • pceltFetched [out]
    The number of HWNDs fetched. Should always be 1 or 0.

Return value

This method can return one of these values.

Return value Description
S_OK

The operation completed successfully.
S_FALSE

End of the list has been reached.
ERROR

An HRESULT error code.

 

Remarks

The first time Next is called, the IEFrame HWND list is created. To get an updated list (in case HWNDs were added or removed), Reset should be called. The next time Next is called it will enumerate the HWNDs again picking up any changes.

See also

IENumManagerFrames