IMimeEnumProperties::Clone method

Creates another enumerator that contains the same enumeration state as the current one.

Syntax

HRESULT Clone(
  [out] IMimeEnumProperties **ppEnum
);

Parameters

ppEnum [out]

Type: IMimeEnumProperties**

Receives the address of a pointer to the new IMimeEnumProperties object.

Return value

Type: HRESULT

Returns one of the following values.

Return code	Description
S_OK	Indicates success.
E_INVALIDARG	Indicates that ppEnum is NULL.
E_OUTOFMEMORY	Indicates that an attempt to allocate memory failed.

Remarks

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 interface as the original one.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Product	Outlook Express 6.0
Header	Mimeole.h
IDL	Mimeole.idl
DLL	Inetcomm.dll (version 6.0 or later)