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

Consulte también

Referencia de servicios de telefonía asistida

Información general de referencia de TAPI 2.2