Función lineGetCallStatus (tapi.h)

Artículo
03/08/2023

La función lineGetCallStatus devuelve el estado actual de la llamada especificada.

Sintaxis

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

Parámetros

hCall

Identificador de la llamada que se va a consultar. El estado de llamada de hCall puede ser cualquier estado.

lpCallStatus

Puntero a una estructura de datos de tamaño variable de tipo LINECALLSTATUS. Una vez completada correctamente la solicitud, esta estructura se rellena con información de estado de llamada. Antes de llamar a lineGetCallStatus, 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_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Comentarios

La función lineGetCallStatus devuelve el estado dinámico de una llamada, mientras que lineGetCallInfo devuelve principalmente información estática sobre una llamada. La información de estado de la llamada incluye el estado de llamada actual, información detallada del modo relacionada con la llamada mientras está en este estado (si existe), así como una lista de las funciones de API disponibles que la aplicación puede invocar en la llamada mientras la llamada está en este estado. Normalmente, una aplicación estaría interesada en solicitar esta información cuando recibe una notificación sobre un cambio de estado de llamada por el mensaje LINE_CALLSTATE.