ITAddress::CreateCall method (tapi3if.h)
The CreateCall method creates a new Call object that can be used to make an outgoing call and returns a pointer to the object's ITBasicCallControl interface. The newly created call is in the CS_IDLE state and has no media or terminals selected.
Acceptable input values for call address, address type, and media types are specific to the telephony service provider that supports the current address. For information on TSPs shipped with Windows 2000, see About The Telephony Service Provider (TSP). For third party TSPs, see the documentation provided by the vender.
HRESULT CreateCall( BSTR pDestAddress, long lAddressType, long lMediaTypes, ITBasicCallControl **ppCall );
This BSTR string contains a destination address. The format is provider-specific. This pointer can be NULL for non-dialed addresses (such as with a hot phone) or when all dialing is performed using ITBasicCallControl::Dial. NULL in combination with a NULLpGroupID in ITBasicCallControl::Pickup results in a group pickup. Service providers that have inverse multiplexing capabilities can allow an application to specify multiple addresses at once.
Contains an address type constant, such as LINEADDRESSTYPE_PHONENUMBER, which describes the format of the address. The value must be valid for this address. Use ITAddressCapabilities::get_AddressCapability with AddressCap set to AC_ADDRESSTYPES to verify the value.
Identifies the media type or types that will be involved in the call session.
Pointer to ITBasicCallControl interface.
This method can return one of these values.
||The address type, lAddressType, is invalid or specifies more than one address type.|
||Insufficient memory exists to perform the operation.|
||The ppCall parameter is not a valid pointer.|
When the address type is LINEADDRESSTYPE_SDP, the application should call the ITSDP::get_IsValid method on pDestAddress to verify that the SDP information contained is properly constructed according to RFC 2327.
Calls used as consultation calls, such as during a conference, transfer, or forward operation, must be created using this method.
TAPI calls the AddRef method on the ITBasicCallControl interface returned by ITAddress::CreateCall. The application must call Release on the ITBasicCallControl interface to free resources associated with it.
|Header||tapi3if.h (include Tapi3.h)|