función TSPI_lineRedirect (tspi.h)
La función TSPI_lineRedirect redirige la llamada de oferta especificada a la dirección de destino especificada.
Sintaxis
LONG TSPIAPI TSPI_lineRedirect(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
Parámetros
dwRequestID
Identificador de la solicitud asincrónica.
hdCall
Identificador de la llamada que se va a redirigir. El estado de llamada de hdCallpuede ofrecerse.
lpszDestAddress
Puntero a una cadena Unicode terminada en null que especifica la dirección de destino. Esto sigue el formato de vínculo estándar.
dwCountryCode
El código de país o región de la entidad a la que se redirige la llamada. Si se especifica un valor de 0, la implementación usa un valor predeterminado. TAPI no valida este parámetro 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_INVALCOUNTRYCODE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.
Comentarios
El proveedor de servicios no redirige la llamada si devuelve LINEERR_INVALADDRESS.
Cuando se invoca esta función, el proveedor de servicios desactiva la llamada de oferta a otra dirección sin responder primero a la llamada. La redirección de llamadas difiere del reenvío de llamadas en que el conmutador realiza el reenvío de llamadas sin la participación de la estación llamada; La redirección se puede realizar mediante una llamada por llamada por una aplicación cliente, por ejemplo controlada por la información del identificador de llamada. Difiere de la transferencia de llamadas en que la transferencia de una llamada requiere que se responda primero a la llamada.
Después de redirigir correctamente una llamada, la llamada normalmente pasa a inactiva. El proveedor de servicios indica el nuevo estado mediante un mensaje de LINE_CALLSTATE .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |