Función lineRegisterRequestRecipient (tapi.h)

Artículo
03/08/2023

La función lineRegisterRequestRecipient registra la aplicación invocada como destinatario de las solicitudes para el modo de solicitud especificado.

Sintaxis

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

Parámetros

hLineApp

Identificador de uso de la aplicación para la parte de línea de TAPI.

dwRegistrationInstance

DWORD específico de la aplicación que se pasa como parámetro del mensaje de LINE_REQUEST. Este mensaje notifica a la aplicación que una solicitud está pendiente. Este parámetro se omite si bEnable se establece en cero. TapI examina este parámetro solo para el registro, no para la desregistración. El valor dwRegistrationInstance usado al anular el registro no necesita coincidir con el dwRegistrationInstance usado al registrarse para un modo de solicitud.

dwRequestMode

Tipo de solicitud para la que se registra la aplicación. Este parámetro usa una o varias de las constantes de LINEREQUESTMODE_.

bEnable

Si es TRUE, la aplicación registra los modos de solicitud especificados; si es FALSE, la aplicación anula el registro de los modos de solicitud especificados.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Comentarios

Una aplicación habilitada para telefonía puede solicitar que se realice una llamada en su nombre invocando tapiRequestMakeCall. Además, otras aplicaciones pueden solicitar que la información se registre con una llamada determinada. Las solicitudes tapiRequestMakeCall son puestas en cola por TAPI y la aplicación de prioridad más alta que se ha registrado para controlar la solicitud se envía un mensaje de LINE_REQUEST con una indicación del modo de la solicitud que está pendiente. Esta aplicación suele ser la aplicación de control de llamadas del usuario.

A continuación, la aplicación de control de llamadas que recibe este mensaje invoca lineGetRequest, especificando el modo de solicitud y un búfer lo suficientemente grande como para contener la solicitud. A continuación, la aplicación de control de llamadas interpreta y ejecuta la solicitud.

La aplicación de destinatario también se anula automáticamente para todas las solicitudes cuando realiza una lineShutdown.