Función lineCompleteCall (tapi.h)

Artículo
08/26/2023

La función lineCompleteCall especifica cómo se debe completar una llamada que no se pudo conectar normalmente. Es posible que la red o el conmutador no puedan completar una llamada porque los recursos de red están ocupados o la estación remota está ocupada o no responde. La aplicación puede solicitar que la llamada se complete de una de varias maneras.

Sintaxis

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

Parámetros

hCall

Controle a la llamada cuya finalización se solicita. La aplicación debe ser propietario de la llamada. El estado de llamada de hCall debe estar ocupado o revertir.

lpdwCompletionID

Puntero a una ubicación de memoria de tamaño DWORD. El identificador de finalización se usa para identificar las solicitudes de finalización individuales en curso. Un identificador de finalización deja de ser válido y se puede reutilizar una vez completada la solicitud o después de cancelar una solicitud pendiente.

dwCompletionMode

Modo en el que se va a completar la llamada. Este parámetro usa una y solo una de las LINECALLCOMPLMODE_ Constantes.

dwMessageID

Mensaje que se va a enviar al completar la llamada mediante LINECALLCOMPLMODE_MESSAGE. Este identificador selecciona el mensaje de un pequeño número de mensajes predefinidos.

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_COMPLETIONOVERRUN, LINEERR_NOMEM, LINEERR_INVALCALLCOMPLMODE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMESSAGEID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED.

Comentarios

Esta función se considera completa cuando la red o el conmutador han aceptado la solicitud; no cuando la solicitud se completa por completo de la manera especificada. Una vez completada esta función, la llamada normalmente pasa a inactiva. Cuando la estación o la red llamadas entran en un estado en el que se puede completar la llamada según se solicite, la aplicación recibe una notificación por un mensaje de LINE_CALLSTATE con el estado de llamada igual a la oferta. El registro LINECALLINFO de la llamada muestra el motivo de la llamada como CALLCOMPLETION y también proporciona el identificador de finalización. Es posible tener varias solicitudes pendientes de finalización de llamadas; el número máximo depende del dispositivo. El identificador de finalización también se usa para hacer referencia a cada solicitud individual para que las solicitudes se puedan cancelar llamando a lineUncompleteCall.