función TSPI_lineBlindTransfer (tspi.h)
La función TSPI_lineBlindTransfer realiza una transferencia ciega o paso único de la llamada especificada a la dirección de destino especificada.
Sintaxis
LONG TSPIAPI TSPI_lineBlindTransfer(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
Parámetros
dwRequestID
Identificador de la solicitud asincrónica.
hdCall
Identificador del proveedor de servicios para la llamada que se va a transferir. El estado de llamada de hdCall se puede conectar.
lpszDestAddress
Puntero a una cadena Unicode terminada en null que identifica dónde se va a transferir la llamada. La dirección de destino usa el formato de número de marcado estándar.
dwCountryCode
Código de país o región del destino. La implementación debe usarla para seleccionar los protocolos de progreso de llamada para la dirección de destino. Si se especifica un valor de 0, el proveedor de servicios debe usar un valor predeterminado. TAPI no valida dwCountryCode cuando se llama a esta función.
Valor devuelto
Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_ADDRESSBLOCKED, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCOUNTRYCODE.
Comentarios
El proveedor de servicios no realiza ninguna marcación si devuelve LINEERR_INVALADDRESS.
La transferencia ciega difiere de una transferencia de consulta en que no se hace visible ninguna llamada de consulta a TAPI. Normalmente, una vez completada correctamente la transferencia ciega, la llamada especificada se borra de la línea en la que estaba y pasa al estado inactivo . El identificador de llamada del proveedor de servicios debe permanecer válido una vez completada la transferencia. TAPI hace que este identificador se invalide cuando ya no está interesado en la llamada transferida mediante TSPI_lineCloseCall.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |