IEnumParticipant::Clone method

[Clone is not available for use in Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The RTC Client API provides similar functionality.]

The Clone method creates another enumerator that contains the same enumeration state as the current one. This method is hidden from Visual Basic and scripting languages.

Syntax

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

Parameters

ppEnum [out]

Pointer to new IEnumParticipant interface.

Return value

This method can return one of these values.

Return code Description
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 IEnumParticipant interface returned by IEnumParticipant::Clone. The application must call Release on the IEnumParticipant interface to free resources associated with it.

Requirements

Requirement Value
TAPI version
Requires TAPI 3.0 or later
Header
Confpriv.h
Library
Uuid.lib
DLL
Tapi3.dll

See also

IEnumParticipant

ITParticipant