función TSPI_lineSendUserUserInfo (tspi.h)
La función TSPI_lineSendUserUserInfo envía información de usuario al usuario remoto en la llamada especificada.
Sintaxis
LONG TSPIAPI TSPI_lineSendUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
Parámetros
dwRequestID
Identificador de la solicitud asincrónica.
hdCall
Identificador de la llamada en la que se va a enviar información del usuario. El estado de llamada de hdCall se puede conectar, ofrecer, aceptar o revertir.
lpsUserUserInfo
Puntero a una cadena Unicode terminada en null que contiene información de usuario-usuario que se va a enviar a la entidad remota. La información del usuario solo se envía si es compatible con la red subyacente (consulte LINEDEVCAPS).
dwSize
El tamaño, en bytes, incluido el terminador NULL , de la información del usuario en lpsUserUserInfo.
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_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.
Comentarios
Esta función se puede usar para enviar información del usuario en cualquier momento durante una llamada conectada. Si el tamaño de la información especificada que se va a enviar es mayor que lo que puede caber en un único mensaje de red (como en ISDN), el proveedor de servicios es responsable de dividir la información en una secuencia de mensajes de red encadenados (con "más datos").
La información del usuario también se puede enviar como parte de la aceptación de llamadas, el rechazo de llamadas, la redirección de llamadas y al realizar llamadas. También se puede recibir información del usuario. La información recibida se notifica en la estructura LINECALLINFO de la llamada. Cada vez que la información del usuario llega después de la oferta de llamada o antes de la desconexión de la llamada, un mensaje de LINE_CALLINFO con un parámetro UserUserInfo notifica a TAPI que la información del usuario en el registro de información de llamada ha cambiado. Si se encadenan varios mensajes de red, el proveedor de servicios ensambla la información y se envía un único mensaje a TAPI.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tspi.h |