Función lineGetNewCalls (tapi.h)

Artículo
03/13/2024

La función lineGetNewCalls devuelve identificadores de llamada a llamadas en una línea o dirección especificadas para las que la aplicación actualmente no tiene identificadores. A la aplicación se le concede privilegios de supervisión a estas llamadas.

Sintaxis

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

Parámetros

hLine

Identificador de un dispositivo de línea abierta.

dwAddressID

Dirección en el dispositivo de línea abierta especificado. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

dwSelect

Selección de llamadas solicitadas. Este parámetro usa una y solo una de las LINECALLSELECT_ Constantes.

lpCallList

Puntero a una estructura de datos de tamaño variable de tipo LINECALLLIST. Tras completar correctamente la solicitud, se devuelven identificadores de llamada a todas las llamadas seleccionadas en esta estructura. Antes de llamar a lineGetNewCalls, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Nota Si los parámetros de tamaño de la estructura no son correctos, existe la posibilidad de que se sobrescriban los datos. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema de asignación de memoria .

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_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Comentarios

Una aplicación puede usar lineGetNewCalls para obtener identificadores para las llamadas a las que actualmente no tiene identificadores. La aplicación puede seleccionar las llamadas para las que se van a devolver los identificadores al basar esta selección en el ámbito (llamadas en una línea especificada o llamadas en una dirección especificada). Por ejemplo, una aplicación puede solicitar identificadores de llamada a todas las llamadas en una dirección determinada para la que actualmente no tiene ningún identificador. La aplicación siempre tiene privilegios de supervisión para los nuevos identificadores de llamada. Además, al abrir una línea, una aplicación usa esta función para conocer las llamadas existentes.

La aplicación puede invocar lineGetCallInfo y lineGetCallStatus para cada llamada de la lista para determinar la información y el estado de la llamada, respectivamente. Puede usar lineSetCallPrivilege para cambiar su privilegio al propietario.