Función lineSendUserUserInfo (tapi.h)

Artículo
08/26/2023

La función lineSendUserUserInfo envía información del usuario al usuario remoto en la llamada especificada.

Sintaxis

LONG lineSendUserUserInfo(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parámetros

hCall

Controle la llamada en la que se va a enviar información del usuario. La aplicación debe ser propietario de la llamada. El estado de llamada de hCall debe estar conectado, ofreciendo, aceptado o revocado.

lpsUserUserInfo

Puntero a una cadena que contiene información del 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). El campo discriminador del protocolo para la información del usuario, si es necesario, debe aparecer como el primer byte del búfer al que apunta lpsUserUserInfo y debe tener en cuenta en dwSize.

dwSize

Tamaño de la información del usuario en lpsUserUserInfo, en bytes.

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_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

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 y la redirección de llamadas, y al realizar llamadas. También se puede recibir información del usuario. La información recibida está disponible a través del registro de información de llamada 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 la aplicación que ha cambiado la información del usuario en el registro de información de llamada. Si se encadenan varios mensajes de red, el proveedor de servicios ensambla la información y se envía un único mensaje a la aplicación.

Esta función puede enviar datos a través de la conexión en forma sin cifrar; por lo tanto, alguien interceptado en la red puede ser capaz de leer los datos. El riesgo de seguridad de enviar los datos en texto no cifrado debe tenerse en cuenta antes de usar este método.