Función lineGetConfRelatedCalls (tapi.h)

Artículo
08/26/2023

La función lineGetConfRelatedCalls devuelve una lista de identificadores de llamada que forman parte de la misma llamada de conferencia que la llamada especificada. La llamada especificada es una llamada de conferencia o una llamada de participante en una llamada de conferencia. Se generan nuevos identificadores para las llamadas para las que la aplicación aún no tiene identificadores y se concede privilegios de supervisión a esas llamadas.

Sintaxis

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

Parámetros

hCall

Identificador de una llamada. Se trata de una llamada de conferencia o una llamada de participante en una llamada de conferencia. En el caso de una llamada primaria de conferencia, el estado de la llamada de hCall puede ser cualquier estado. En el caso de una llamada a participantes de conferencia, debe estar en el estado de conferencia .

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 de la llamada de conferencia en esta estructura. La primera llamada de la lista es la llamada de conferencia, las otras llamadas son las llamadas de participantes. A la aplicación se le concede privilegios de supervisión a las llamadas para las que aún no tiene identificadores; los privilegios a las llamadas de la lista para las que la aplicación ya tiene identificadores no se modifican. Antes de llamar a lineGetConfRelatedCalls, 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_OPERATIONFAILED, LINEERR_NOCONFERENCE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Comentarios

La llamada especificada puede ser un identificador de llamada de conferencia o un identificador para una llamada de participante. Por ejemplo, una llamada de consulta que aún no se ha agregado a una llamada de conferencia no forma parte de una conferencia. La primera entrada de la lista que se devuelve es el identificador de llamada de conferencia, los demás identificadores son todas las llamadas de participante. La llamada especificada siempre es una de las llamadas devueltas en la lista. Se asignan privilegios de supervisión a las llamadas de la lista a las que la aplicación aún no tiene un identificador de llamada; privilegios para las llamadas a las que la aplicación ya tiene identificadores no se modifican. La aplicación puede usar lineSetCallPrivilege para cambiar el privilegio de la llamada.

Si se llama a lineGetConfRelatedCalls inmediatamente después de agregar una llamada a una conferencia mediante lineCompleteTransfer, es posible que lineGetConfRelatedCalls no devuelva una lista completa de llamadas relacionadas porque TAPI espera recibir un mensaje de LINE_CALLSTATE que indica que la llamada ha entrado LINECALLSTATE_CONFERENCED antes de considerar que la llamada forma parte realmente de la conferencia (es decir, el estado con conferencia lo confirma el proveedor de servicios). Una vez que la aplicación haya recibido el mensaje LINE_CALLSTATE, lineGetConfRelatedCalls devuelve información completa.

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.