TSPI_lineHold función (tspi.h)
La función TSPI_lineHold coloca la llamada especificada en espera.
Sintaxis
LONG TSPIAPI TSPI_lineHold(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Parámetros
dwRequestID
Identificador de la solicitud asincrónica.
hdCall
Identificador del proveedor de servicios para la llamada que se va a colocar en espera. El estado de llamada de hdCall se puede conectar.
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 ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Comentarios
La llamada en espera se desconecta temporalmente, lo que permite que TAPI use el dispositivo de línea para realizar o responder a otras llamadas. TSPI_lineHold realiza una suspensión dura de la llamada especificada, en lugar de una llamada de consulta. Normalmente, una llamada en espera dura no se puede transferir ni incluir en una llamada de conferencia, mientras que una llamada de consulta puede. Las llamadas de consulta se inician mediante TSPI_lineSetupTransfer, TSPI_lineSetupConference o TSPI_linePrepareAddToConference.
Una vez que una llamada se coloca correctamente en espera, el estado de la llamada normalmente pasa a onHold. Una llamada mantenida se recupera a través de TSPI_lineUnhold. Mientras una llamada está en espera, el proveedor de servicios puede enviar LINE_CALLSTATE mensajes sobre los cambios de estado de la llamada mantenida. Por ejemplo, si la parte detenida se bloquea, el estado de llamada puede pasar a desconectado y el proveedor de servicios puede enviar un mensaje de LINE_CALLSTATE que indica el nuevo estado.
Requisitos
Plataforma de destino | Windows |
Encabezado | tspi.h |