Función lineSetAppSpecific (tapi.h)

Artículo
03/05/2024

La función lineSetAppSpecific permite a una aplicación establecer el campo específico de la aplicación del registro de información de llamada de la llamada especificada.

Sintaxis

LONG lineSetAppSpecific(
  HCALL hCall,
  DWORD dwAppSpecific
);

Parámetros

hCall

Controle la llamada cuyo campo específico de la aplicación debe establecerse. La aplicación debe ser propietario de la llamada. El estado de llamada de hCall puede ser cualquier estado.

dwAppSpecific

Nuevo contenido del miembro dwAppSpecific para la estructura LINECALLINFO de la llamada. La API de telefonía no interpreta este valor.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

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

Comentarios

La API de telefonía ni ninguno de sus proveedores de servicios interpreta el campo específico de la aplicación en la estructura de datos LINECALLINFO que existe para cada llamada. Las aplicaciones definen completamente su uso. El campo se puede leer desde el registro LINECALLINFO devuelto por lineGetCallInfo. Sin embargo, lineSetAppSpecific debe usarse para establecer el campo para que los cambios sean visibles para otras aplicaciones. Cuando se cambia este campo, todas las demás aplicaciones con identificadores de llamada se envían un mensaje de LINE_CALLINFO con una indicación de que el miembro dwAppSpecific ha cambiado.