Función lineReleaseUserUserInfo (tapi.h)

Artículo
03/08/2023

La función lineReleaseUserUserInfo informa al proveedor de servicios de que la aplicación ha procesado la información del usuario-usuario contenida en la estructura LINECALLINFO y que posteriormente se puede escribir información de usuario-usuario en esa estructura. El proveedor de servicios envía un mensaje de LINE_CALLINFO que indica LINECALLINFOSTATE_USERUSERINFO cuando hay nueva información disponible.

Sintaxis

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

Parámetros

hCall

Identificador de la llamada. La aplicación debe ser propietario de la llamada. El estado de llamada de hCall puede ser cualquier estado.

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 ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED, LINEERR_OPERATIONUNAVAIL.

Comentarios

La función lineReleaseUserUserInfo permite a la aplicación controlar el flujo de información entrante del usuario-usuario en una conexión ISDN. Cuando se recibe un nuevo mensaje de información de usuario-usuario completo, el proveedor de servicios informa a la aplicación mediante un mensaje de LINE_CALLINFO (especificando LINECALLINFOSTATE_USERUSERINFO). Cualquier número de aplicaciones puede examinar la información (mediante lineGetCallInfo), pero la aplicación que posee los controles de llamada cuando se libera la información para que se pueda notificar la información subsiguiente. El proveedor de servicios no sobrescribirá la información anterior del usuario-usuario en LINECALLINFO con información más reciente hasta que se haya llamado a lineReleaseUserUserInfo . Es responsabilidad del proveedor de servicios almacenar en búfer la información de usuario-usuario recibida posteriormente hasta que la aplicación que posee la llamada libere la información anterior.