ITBasicCallControl::Finish method (tapi3if.h)

The Finish method is called on a consultation call to finish a conference or a transfer.

Syntax

HRESULT Finish(
  [in] FINISH_MODE finishMode
);

Parameters

[in] finishMode

A FINISH_MODE indicator of the type of call being finished, such as FM_ASCONFERENCE.

Return value

This method can return one of these values.

Return code Description
S_OK
Method succeeded.
TAPI_E_INVALCALLSTATE
Call is not flagged as a transfer or a conference.
TAPI_E_TIMEOUT
The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.

Remarks

Some service providers do not support this operation while streaming is active. The application may need to call ITStream::StopStream or ITSubStream::StopSubStream prior to the operation and ITStream::StartStream or ITSubStream::StartSubStream following completion of the operation.

Requirements

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

See also

Call Object

Conference

Conference overview

Create a Simple Conference code snippet

FINISH_MODE

Forward overview

ITBasicCallControl

Transfer

Transfer overview