Función lineBlindTransfer (tapi.h)

Artículo
08/26/2023

La función lineBlindTransfer realiza una transferencia ciega o de un solo paso de la llamada especificada a la dirección de destino especificada.

Sintaxis

LONG lineBlindTransfer(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Parámetros

hCall

Identificador de la llamada que se va a transferir. La aplicación debe ser propietario de esta llamada. El estado de llamada de hCall debe estar conectado.

lpszDestAddress

TBD

dwCountryCode

Código de país o región del destino. Esta implementación la usa para seleccionar los protocolos de progreso de la llamada para la dirección de destino. Si se especifica un valor de 0, se usa un protocolo de progreso de llamada predeterminado definido por el proveedor de servicios.

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_INVALCALLHANDLE, LINEERR_INVALCOUNTRYCODE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_ADDRESSBLOCKED, LINEERR_OPERATIONFAILED.

Comentarios

Si se devuelve LINEERR_INVALADDRESS, no se produce ninguna marcación.

La transferencia ciega difiere de una transferencia de consulta en que no se hace visible ninguna llamada de consulta a la solicitud. Una vez completada correctamente la transferencia ciega, la llamada especificada normalmente se borra de la línea de la aplicación y pasa al estado inactivo .

El identificador de llamada de la aplicación sigue siendo válido una vez completada la transferencia. La aplicación debe desasignar su identificador mediante lineDeallocateCall cuando ya no esté interesado en la llamada transferida.