IEnumCATID::Clone method

  • Article

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] IEnumCATID **ppenum
);

Parameters

  • ppenum [out]
    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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

 ComCat.h

IDL

 ComCat.idl

IID

IID_IEnumCatID is defined as 0002E000-0000-0000-C000-000000000046

See also

IEnumCATID