ITBasicCallControl::Connect method (tapi3if.h)
The Connect method attempts to complete the connection of an outgoing call.
Syntax
HRESULT Connect(
[in] VARIANT_BOOL fSync
);
Parameters
[in] fSync
Boolean indicating whether connection is to be performed synchronously (VARIANT_TRUE) or asynchronously (VARIANT_FALSE).
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
Method succeeded. |
|
Call state must be CS_IDLE. |
|
The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes. |
|
Insufficient memory exists to perform the operation. |
Remarks
If the call is asynchronous, the application will receive information about the call's progress through the ITCallNotificationEvent outgoing interface. The application must register the outgoing interface before calling Connect. Connect may return S_OK, but the actual connection may fail (and the application will be notified through the outgoing interface).
If the call is synchronous, this method will not return until the call is in the connected state or fails.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (include Tapi3.h) |
| Library | Uuid.lib |
| DLL | Tapi3.dll |