Edit

Share via

IEnumStream::Clone method (tapi3if.h)

  • Article

The Clone method creates another enumerator that contains the same enumeration state as the current one.

Syntax

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

Parameters

[out] ppEnum

Pointer to new IEnumStream interface.

Return value

This method can return one of these values.

Value Meaning
S_OK
 Method succeeded.
E_POINTER
 The ppEnum parameter is not a valid pointer.
E_OUTOFMEMORY
 Insufficient memory exists to perform the operation.
E_UNEXPECTED
 Failed for unknown reasons.

Remarks

TAPI calls the AddRef method on the IEnumStream interface returned by IEnumStream::Clone. The application must call Release on the IEnumStream interface to free resources associated with it.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)

See also

IEnumStream

ITStream

Media Service Provider Interface (MSPI)