Edit

Share via

IEnumAgent::Clone method (tapi3.h)

  • Article

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

Syntax

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

Parameters

[out] ppEnum

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

Requirements

Requirement Value
Target Platform Windows
Header tapi3.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

IEnumAgent

ITAgent