tapiRequestMakeCall
A version of this page is also available for
4/8/2010
Use this function to request the establishment of a voice call. A separate call-management application is responsible for establishing the voice call on behalf of the requesting application. This voice call is subsequently controlled by the user's call-manager application.
Syntax
LONG tapiRequestMakeCall (
LPCTSTR lpszDestAddress,
LPCTSTR lpszAppName,
LPCTSTR lpszCalledParty,
LPCTSTR lpszComment
);
Parameters
- lpszDestAddress
A pointer to a memory location where the null-terminated destination address of the call request is located. The address can use the canonical address format. Validity of the specified address is not checked by this operation. The maximum length of the address is TAPIMAXDESTADDRESSSIZE characters, which includes the NULL terminator.
- lpszAppName
This parameter is reserved for future use; the value of this parameter must be set to NULL.
- lpszCalledParty
A pointer to a memory location where the null-terminated called party name for the called party of the call is located. This pointer can be left NULL if the application does not wish to supply this information. The maximum length of the string is TAPIMAXCALLEDPARTYSIZE characters, which includes the NULL terminator. Longer strings are truncated.
- lpszComment
This parameter is reserved for future use; the value of this parameter must be set to NULL.
Return Value
Returns zero if the request succeeds or a negative error number if an error occurs. The following table describes possible error-return values.
| Name | Value | Description |
|---|---|---|
TAPIERR_NOREQUESTRECIPIENT |
-2L |
No recipient application is available to handle the request. |
TAPIERR_REQUESTQUEUEFULL |
-3L |
The recipient application is active, but its request queue is full or there is insufficient memory to expand the queue. The calling application should try again later. |
TAPIERR_INVALDESTADDRESS |
-4L |
The pointer to the destination address is not valid, is NULL, or the destination address string is too long. |
TAPIERR_REQUESTFAILED |
-16L |
Not used. Reserved for future use. |
TAPIERR_REQUESTCANCELLED |
-17L |
Not used. Reserved for future use. |
TAPIERR_INVALPOINTER |
-18L |
A pointer does not reference a valid memory location. One or more of the pointers lpszDestAddress, lpszAppName, lpszCalledParty, or lpszComment have been specified but are invalid. |
Remarks
A telephony-enabled application can request that a call be placed on its behalf by invoking tapiRequestMakeCall and providing the destination address for the call. This request is forwarded to the system's registered call-control application, which places the call on behalf of the original application. A default call-control application is provided as part of the underlying platform.
Invoking tapiRequestMakeCall when no call control application is available returns the TAPIERR_NOREQUESTRECIPIENT error indication. Invoking this function when the Assisted TAPI request queue is full returns the TAPIERR_REQUESTQUEUEFULL error.
Requirements
| Header | astdtapi.h |
| Library | cellcore.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |