IEnumAgentHandler::Clone method (tapi3cc.h)

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

Syntax

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

Parameters

[out] ppEnum

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

Requirements

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

See also

IEnumAgentHandler