IVoIPCurrentCall2::AddParticipantToConference (Windows CE 5.0)

Send Feedback

This method creates a conference call and adds the specified call, or adds the specified call to an already created conference. The call on which this method is called either becomes a conference call host (if the current call was not already a host), or remains a conference call host (if the current call was already a host).

Both calls must be connected or on hold.

HRESULT AddParticipantToConference(
  IVoIPCurrentCall *piCall);

Parameters

  • piCall
    [in] A pointer to the IVoIPCurrentCall reference that represents the call to be added to the conference.

Return Values

The following table shows possible return values.

Value Description
E_OUTOFMEMORY There was not enough memory to add the new call to the conference.
E_POINTER The piCall pointer is NULL.
S_OK The call was successfully added to the conference.
VOIP_E_INVALIDCALLSTATUS This return value can be returned in more than one situation:
  • The call represented by this object, not by the piCall parameter, is already part of a conference. A call that is already part of a conference cannot be a conference host.
  • The call represented by this object is not currently connected or on hold, so it cannot add participants.
  • The call to add is already part of a conference. Calls that are already part of a conference cannot be added to another conference.
  • The call to add is already a conference host. Calls that are already conference hosts cannot be added to a different conference.
  • The other call is not connected or on hold. The call to be added to the conference must be connected or on hold.
VOIP_E_NOTCURRENTCALL This call is not a current call.
VOIP_E_TOOMANYCONFERENCEPARTICIPANTS The conference already has the maximum number of participants. The maximum number of participants depends on the media manager implementation and is controlled using the LocalConferenceLimit registry entry. For more information about this registry entry, see VAIL Configuration Registry Settings.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: Voipmanager.h, Voipmanager.idl.
Link Library: Voipguid.lib.

See Also

IVoIPCurrentCall2 | VAIL Call Conferencing

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.