IVssEnumObject::Clone method (vss.h)

Article
02/22/2024

The Clone method creates a copy of the specified list of enumerated elements by creating a copy of the IVssEnumObject enumerator object.

Syntax

HRESULT Clone(
  [in, out] IVssEnumObject **ppenum
);

Parameters

[in, out] ppenum

Doubly indirect pointer to an IVssEnumObject enumerator object. Set the value of this parameter to NULL before calling this method.

Return value

The following are the valid return codes for this method.

Value	Meaning
S_OK	The operation was successful.
E_FAIL	There is an internal error in the enumerator.
E_OUTOFMEMORY	The caller is out of memory or other system resources.
E_POINTER	One of the required pointer parameters is NULL.

Remarks

The cloned enumerator object will refer to the same list of VSS_OBJECT_PROP structures.

The caller must call the Release method of the returned interface pointer to deallocate the system resources held by the IVssEnumObject enumerator object pointed to by the ppEnum parameter.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	vss.h
Library	VssApi.lib