Creates another enumerator with the same enumeration state as the current one.

HRESULT Clone(

    IEnumHLITEM 

** ppenumhlitem           // Location to return the new enumerator        
                                                                                          

   );                                                                                     
                                                                                          

ppenumhlitem

[out] Location to return the new enumerator. Must be cleared to NULL on failure.

Return Values

S_OK

Indicates the enumerator has been duplicated successfully.

E_OUTOFMEMORY

Indicates insufficient memory to create the new enumerator.