Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

TAPI.CreateCall

Creates a new phone call.

Component Version macOS Windows Linux Server iOS SDK
TAPI 4.4 ❌ No ✅ Yes ❌ No ❌ No ❌ No
MBS( "TAPI.CreateCall"; AddressNameIndex; DestAddress; AddressType; MediaTypes )   More

Parameters

Parameter Description Example
AddressNameIndex The index of the address or the name of the address to identify which device to use. 0
DestAddress This text contains a destination address. The format is provider-specific. This can be "" for non-dialed addresses (such as with a hot phone) or when all dialing is performed using TAPI.Dial. "" in combination with a "" GroupID in TAPI.Pickpup results in a group pickup. Service providers that have inverse multiplexing capabilities can allow an application to specify multiple addresses at once. "123456789"
AddressType Contains an address type constant, such as phone number (1), which describes the format of the address. Phone Number is 1, Session Description Protocol (SDP) conference is 2, an e-mail name is 4, a domain name is 8, an IP address is 16. 1
MediaTypes Identifies the media type or types that will be involved in the call session. Can be 8 for audio. 8

Result

Returns Call Reference ID or error.

Description

Creates a new phone call.
The new call will be the new current call, so the TAPI.Dial function (and others) should work on it.

See for media types:
http://msdn.microsoft.com/de-de/library/windows/desktop/ms734210(v=vs.85).aspx

See for line address constants:
http://msdn.microsoft.com/de-de/library/windows/desktop/ms733291(v=vs.85).aspx

If your TAPI drivers are 32-bit only, it may or may not work in 64-bit.

Examples

Creates a call and connects:

$Call = MBS( "TAPI.CreateCall"; "MyPhone"; "1234567899"; 1; 8)
$r = MBS( "TAPI.Connect"; $Call; 1 )

See also

Blog Entries

This function checks for a license.

Created 8th November 2014, last changed 11st May 2016


TAPI.Connect - TAPI.Dial