IVssEnumObject::Clone method (vss.h)

  • Article

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

See also

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP