IEnumGUID::Clone method (comcat.h)

Creates a new enumerator that contains the same enumeration state as the current one.

This method makes it possible to record a point in the enumeration sequence in order to return to that point at a later time. The caller must release this new enumerator separately from the first enumerator.

Syntax

HRESULT Clone(
  [out] IEnumGUID **ppenum
);

Parameters

[out] ppenum

A pointer to the cloned enumerator object.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and S_OK.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	comcat.h

See also

IEnumGUID