Função lineGetConfRelatedCalls (tapi.h)

Artigo
03/02/2024

A função lineGetConfRelatedCalls retorna uma lista de identificadores de chamada que fazem parte da mesma chamada em conferência que a chamada especificada. A chamada especificada é uma chamada em conferência ou uma chamada de participante em uma chamada em conferência. Novos identificadores são gerados para as chamadas para as quais o aplicativo ainda não tem identificadores e o aplicativo recebe privilégio de monitor para essas chamadas.

Sintaxe

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

Parâmetros

hCall

Manipule para uma chamada. Essa é uma chamada em conferência ou uma chamada de participante em uma chamada em conferência. Para uma chamada pai de conferência, o estado de chamada de hCall pode ser qualquer estado. Para uma chamada de participante da conferência, ela deve estar no estado de conferência .

lpCallList

Ponteiro para uma estrutura de dados de tamanho variavelmente do tipo LINECALLLIST. Após a conclusão bem-sucedida da solicitação, os identificadores de chamada para todas as chamadas na chamada em conferência são retornados nessa estrutura. A primeira chamada na lista é a chamada em conferência, as outras chamadas são as chamadas dos participantes. O aplicativo recebe privilégio de monitor para as chamadas para as quais ele ainda não tem identificadores; os privilégios para chamadas na lista para a qual o aplicativo já tem identificadores não são alterados. Antes de chamar lineGetConfRelatedCalls, o aplicativo deve definir o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Nota Se os parâmetros de tamanho na estrutura não estiverem corretos, há a possibilidade de que os dados possam ser substituídos. Para obter mais informações sobre como definir tamanhos de estrutura, consulte o tópico de alocação de memória .

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOCONFERENCE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM LINEERR_UNINITIALIZED.

Comentários

A chamada especificada pode ser um identificador de chamada em conferência ou um identificador para uma chamada de participante. Por exemplo, uma chamada de consulta que ainda não foi adicionada a uma teleconferência não faz parte de uma conferência. A primeira entrada na lista retornada é o identificador de chamada em conferência, os outros identificadores são todas as chamadas de participantes. A chamada especificada é sempre uma das chamadas retornadas na lista. As chamadas na lista à qual o aplicativo ainda não tem um identificador de chamada recebem privilégio de monitor; os privilégios para chamadas para as quais o aplicativo já tem identificadores permanecem inalterados. O aplicativo pode usar lineSetCallPrivilege para alterar o privilégio da chamada.

Se lineGetConfRelatedCalls for chamado imediatamente após uma chamada ser adicionada a uma conferência usando lineCompleteTransfer, lineGetConfRelatedCalls poderá não retornar uma lista completa de chamadas relacionadas porque TAPI aguarda para receber uma mensagem LINE_CALLSTATE indicando que a chamada foi inserida LINECALLSTATE_CONFERENCED antes de considerar que a chamada realmente faz parte da conferência (ou seja, o estado de conferência é confirmado pelo provedor de serviços). Depois que o aplicativo receber a mensagem LINE_CALLSTATE, lineGetConfRelatedCalls retornará informações completas.

O aplicativo pode invocar lineGetCallInfo e lineGetCallStatus para cada chamada na lista para determinar as informações da chamada e status, respectivamente.