Función tapiRequestMakeCall (tapi.h)
La función tapiRequestMakeCall solicita el establecimiento de una llamada de voz. Una aplicación de administrador de llamadas es responsable de establecer la llamada en nombre de la aplicación solicitante, que luego se controla mediante la aplicación de administrador de llamadas del usuario.
Sintaxis
LONG tapiRequestMakeCall(
LPCSTR lpszDestAddress,
LPCSTR lpszAppName,
LPCSTR lpszCalledParty,
LPCSTR lpszComment
);
Parámetros
lpszDestAddress
Puntero a una ubicación de memoria donde se encuentra la dirección de destino terminada en null de la solicitud de llamada. La dirección puede usar el formato de dirección canónica . Esta operación no comprueba la validez de la dirección especificada. La longitud máxima de la dirección es los caracteres TAPIMAXDESTADDRESSSIZE, que incluye el terminador NULL .
lpszAppName
Puntero a una ubicación de memoria donde se encuentra el nombre de aplicación descriptivo terminado en null de la solicitud de llamada. Este puntero se puede dejar NULL si la aplicación no proporciona un nombre de aplicación. La longitud máxima de la dirección es los caracteres TAPIMAXAPPNAMESIZE, que incluye el terminador NULL . Las cadenas de mayor longitud se truncarán.
lpszCalledParty
Puntero a una ubicación de memoria en la que se encuentra el nombre de entidad llamado null terminado para la parte llamada de la llamada. Este puntero se puede dejar NULL si la aplicación no desea proporcionar esta información. La longitud máxima de la cadena es los caracteres TAPIMAXCALLEDPARTYSIZE, que incluye el terminador NULL . Las cadenas de mayor longitud se truncarán.
lpszComment
Puntero a una ubicación de memoria donde se encuentra el comentario terminado en null sobre la llamada. Este puntero se puede dejar NULL si la aplicación no proporciona un comentario. La longitud máxima de la dirección es los caracteres TAPIMAXCOMMENTSIZE, que incluye el terminador NULL . Las cadenas de mayor longitud se truncarán.
Valor devuelto
Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. El valor devuelto de error posible es:
TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL, TAPIERR_INVALPOINTER.
Comentarios
Una aplicación habilitada para telefonía puede solicitar que una llamada se realice en su nombre invocando tapiRequestMakeCall, proporcionando solo la dirección de destino de la llamada. Esta solicitud se reenvía a la aplicación de control de llamadas del usuario, que coloca la llamada en nombre de la aplicación original. Se proporciona una aplicación de control de llamadas predeterminada como parte de la telefonía. Los usuarios pueden reemplazarlo por una aplicación de control de llamadas de su elección.
Al invocar tapiRequestMakeCall cuando no se ejecuta ninguna aplicación de control de llamadas, se devuelve la indicación de error TAPIERR_NOREQUESTRECIPIENT. Si la aplicación de control de llamadas no se está ejecutando, TAPI intenta iniciar la aplicación de control de llamadas de prioridad más alta (que aparece para RequestMakeCall en el registro). La invocación de esta función cuando la cola de solicitudes TAPI asistida está llena devuelve el error TAPIERR_REQUESTQUEUEFULL.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |