IEnumSTATSTG::Clone method

The Clone method creates a new enumerator that contains the same enumeration state as the current STATSTG structure enumerator. Using this method, a client can record a particular point in the enumeration sequence and then return to that point at a later time. The new enumerator supports the same IEnumSTATSTG interface.

Syntax


HRESULT Clone(
  [out] IEnumSTATSTG **ppenum
);

Parameters

ppenum [out]

A pointer to the variable that receives the IEnumSTATSTG interface pointer.

If the method is unsuccessful, the value of the ppenum parameter is undefined.

Return value

This method supports the following return values.

Return codeDescription
E_INVALIDARG

The ppenum parameter is NULL.

E_OUTOFMEMORY

Insufficient memory.

E_UNEXPECTED

An unexpected exception occurred.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

Objidl.h

IDL

Objidl.idl

Library

Uuid.lib

DLL

Ole32.dll

IID

IID_IEnumSTATSTG is defined as 0000000D-0000-0000-C000-000000000046

 

 

Show: