Share via


IEnumSpObjectTokens::Clone (Windows Embedded CE 6.0)

1/6/2010

This method creates a new enumerator object with the same items and of the same interface type as the one being cloned. It retrieves a new enumerator object with the same items but an independent index. The items in the clone are not guaranteed to be in the same order as in the original enumerator. Using Clone, it is possible to record a particular point in the enumeration sequence and then return to that point at a later time.

Syntax

HRESULT Clone(
  IEnumSpObjectTokens** ppEnum
);

Parameters

  • ppEnum
    [out] Address of a pointer to the IEnumSpObjectTokens interface.

Return Value

The following table shows the possible return values.

Value Description

S_OK

Function completed successfully.

SPERR_UNINITIALIZED

Attribute parser interface is not initialized.

FAILED(hr)

Appropriate error message.

Requirements

Header sapi.h, sapi.idl
Library sapilib.lib
Windows Embedded CE Windows CE .NET 4.1 and later

See Also

Reference

IEnumSpObjectTokens
SAPI Interfaces