Función lineGetCallInfo (tapi.h)

Artículo
03/05/2024

La función lineGetCallInfo permite a una aplicación obtener información fija sobre la llamada especificada.

Sintaxis

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

Parámetros

hCall

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

lpCallInfo

Puntero a una estructura de datos de tamaño variable de tipo LINECALLINFO. Tras completar correctamente la solicitud, esta estructura se rellena con información relacionada con llamadas. Antes de llamar a lineGetCallInfo, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

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

Existe una estructura LINECALLINFO independiente para cada llamada entrante o saliente. La estructura contiene principalmente información fija sobre la llamada. Normalmente, una aplicación estaría interesada en comprobar esta información cuando recibe su identificador para una llamada por el mensaje LINE_CALLSTATE , o cada vez que recibe una notificación por un mensaje de LINE_CALLINFO que han cambiado las partes de la estructura de información de llamadas. Estos mensajes proporcionan el identificador de la llamada como parámetro.