Função lineRemoveFromConference (tapi.h)

Artigo
08/26/2023

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

Sintaxe

LONG lineRemoveFromConference(
  HCALL hCall
);

Parâmetros

hCall

Manipule para a chamada a ser removida da conferência. O aplicativo deve ser um proprietário dessa chamada. O estado de chamada de hCall deve ser conferência.

Valor retornado

Retorna um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de LINE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

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

Comentários

Esta 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 removida automaticamente (torna-se ociosa). Consulte os recursos de dispositivo da linha para determinar os 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, a chamada do participante, depois de ser removida da conferência, entrará no estado de chamada listado no membro dwRemoveFromConfState em LINEADDRESSCAPS.