Microsoft Speech Platform

---

IEnumSpObjectTokens::Clone

IEnumSpObjectTokens::Clone creates a new enumerator object with the same items.

Returns 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 the original enumerator.

HRESULT Clone(
   IEnumSpObjectTokens   **ppEnum
);

Parameters

ppEnum

[out] Address of the IEnumSpObjectTokens pointer variable that receives the interface pointer to the cloned 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. The enumerator returned is of the same interface type as the one being cloned.

Return values

Value	Description
S_OK	Function completed successfully.
SPERR_UNINITIALIZED	Attribute parser interface is not initialized.
FAILED (hr)	Appropriate error message.