Función lineAnswer (tapi.h)

Artículo
08/26/2023

La función lineAnswer responde a la llamada de oferta especificada.

Sintaxis

LONG lineAnswer(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parámetros

hCall

Identificador de la llamada que se va a responder. La aplicación debe ser propietario de esta llamada. El estado de llamada de hCall debe ser ofrecido o aceptado.

lpsUserUserInfo

Puntero a una cadena terminada en null que contiene información de usuario-usuario que se va a enviar a la entidad remota en el momento en que se responde a la llamada. Este puntero se puede dejar NULL si no se va a enviar información del usuario. La información del usuario solo se envía si es compatible con la red subyacente (consulte LINEDEVCAPS). El campo discriminador del protocolo para la información del usuario, si es necesario, debe aparecer como el primer byte del búfer al que apunta lpsUserUserInfo y debe tener en cuenta en dwSize.

dwSize

Tamaño de la información de usuario-usuario en lpsUserUserInfo (incluido el terminador NULL ), en bytes Si lpsUserUserInfo es NULL, no se envía información de usuario a la entidad que realiza la llamada y dwSize se omite.

Valor devuelto

Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de LINE_REPLY correspondiente es cero si la función se realiza correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_NOTOWNER.

Comentarios

Cuando llega una nueva llamada, las aplicaciones con interés en la llamada se envían un mensaje de LINE_CALLSTATE para proporcionar el nuevo identificador de llamada e informar a la aplicación sobre el estado de la llamada y los privilegios de la nueva llamada (por ejemplo, monitor o propietario). La aplicación con privilegios de propietario para la llamada puede responder a esta llamada mediante lineAnswer. Una vez que se haya respondido correctamente a la llamada, la llamada normalmente pasa al estado conectado . Inicialmente, solo se concede un privilegio de propietario a una aplicación a la llamada entrante.

En algunos entornos de telefonía (como ISDN), donde la alerta de usuario es independiente de la oferta de llamadas, la aplicación puede tener la opción de aceptar una llamada antes de responder o rechazar o redirigir la llamada de oferta.

Si aparece una llamada (se ofrece) en el momento en que otra llamada ya está activa, invocar lineAnswer se conecta a la nueva llamada. El efecto que esto tiene en la llamada activa existente depende de las funcionalidades del dispositivo de la línea. La primera llamada puede no verse afectada, se puede quitar automáticamente o se puede colocar automáticamente en espera. Los mensajes LINE_CALLSTATE adecuados notifican las transiciones de estado a la aplicación sobre ambas llamadas.

En una situación puente, si una llamada está conectada, pero en el estado LINECONNECTEDMODE_INACTIVE, se puede unir mediante la función lineAnswer .

La aplicación tiene la opción de enviar información del usuario al momento de la respuesta. Incluso si se puede enviar información de usuario-usuario, no hay ninguna garantía de que la red entregará esta información al usuario que realiza la llamada. Una aplicación debe consultar las funcionalidades del dispositivo de una línea para determinar si el envío de información del usuario al responder a la llamada está disponible.