IEnumSTATPROPSETSTG::Clone method (propidlbase.h)

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

Syntax

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

Parameters

[out] ppenum

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

If the method does not succeed, the value of the ppenum parameter is undefined.

Return value

This method supports return values listed in the following table.

Return code Description
E_INVALIDARG
The ppenum parameter is NULL.
E_OUTOFMEMORY
Insufficient memory.
E_UNEXPECTED
An unexpected exception occurred.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header propidlbase.h (include Propidl.h)
Library Uuid.lib
DLL Ole32.dll