função TSPI_lineRemoveFromConference (tspi.h)

Artigo
08/26/2023

A função TSPI_lineRemoveFromConference remove a chamada especificada da chamada em conferência à qual ela pertence atualmente. As chamadas restantes na teleconferência não são afetadas.

Sintaxe

LONG TSPIAPI TSPI_lineRemoveFromConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador para a chamada a ser removida da conferência. O estado de chamada de hdCall pode ser conferência.

Valor retornado

Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentários

Essa operação remove uma parte que atualmente pertence a uma chamada em conferência. Depois que a chamada tiver sido removida com êxito, talvez seja possível manipulá-la ainda mais usando seu identificador. A disponibilidade dessa operação e seu resultado provavelmente serão limitados em muitas implementações. Por exemplo, em muitas implementações, somente a parte adicionada mais recentemente pode ser removida de uma conferência e a chamada removida pode ser descartada automaticamente (fica ociosa). O provedor de serviços indica seus recursos no LINEDEVCAPS em relação aos efeitos disponíveis da remoção de uma chamada de uma conferência.

Se houver suporte para a remoção de um participante de uma conferência, o provedor de serviços deverá indicar no membro dwRemoveFromConfState em LINEADDRESSCAPS o estado de chamada para o qual a chamada faz a transição depois de ser removida da conferência.