IEnumString::Clone
A version of this page is also available for
4/8/2010
This method creates another enumerator that contains the same enumeration state as the current one.
Using this function, a client can record a particular point in the enumeration sequence and return to that point at a later time. The new enumerator supports the same interface as the original one.
Syntax
HRESULT Clone(
IEnumString** ppenum
);
Parameters
ppenum
[out] Address of the IEnumString pointer variable that receives the interface pointer to the enumeration object.If the method is unsuccessful, the value of this output variable is undefined.
Return Value
This method supports the standard return values E_INVALIDARG, E_OUTOFMEMORY, and E_UNEXPECTED.
Remarks
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |