Edit

Share via

IEnumSubStream::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] IEnumSubStream **ppEnum
);

Parameters

[out] ppEnum

Pointer to new IEnumSubStream 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 IEnumSubStream interface returned by IEnumSubStream::Clone. The application must call Release on the IEnumSubStream interface to free resources associated with it.

Requirements

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

See also

IEnumSubStream

ITSubStream

Media Service Provider Interface (MSPI)