IEnumSpObjectTokens::Clone (SAPI 5.4)

  • Article

Microsoft Speech API 5.4

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
S_OK
SPERR_UNINITIALIZED
FAILED (hr)