Função lineHold (tapi.h)

Artigo
08/26/2023

A função lineHold coloca a chamada especificada em espera.

Sintaxe

LONG lineHold(
  HCALL hCall
);

Parâmetros

hCall

Manipule para a chamada a ser colocada em espera. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall deve estar conectado.

Retornar valor

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

A chamada em espera é temporariamente desconectada, permitindo que o aplicativo use o dispositivo de linha para fazer ou atender outras chamadas. A função lineHold executa o chamado "bloqueio rígido" da chamada especificada (em vez de uma "chamada de consulta"). Uma chamada em espera forçada normalmente não pode ser transferida ou incluída em uma teleconferência, mas uma chamada de consulta pode. As chamadas de consulta são iniciadas usando lineSetupTransfer, lineSetupConference ou linePrepareAddToConference.

Depois que uma chamada é colocada em espera com êxito, o estado de chamada normalmente faz a transição para onHold. Uma chamada mantida é recuperada por lineUnhold. Enquanto uma chamada está em espera, o aplicativo pode receber mensagens LINE_CALLSTATE sobre alterações de estado da chamada mantida. Por exemplo, se a parte mantida desligar, o estado de chamada poderá fazer a transição para desconectado.

Em uma situação de ponte, uma operação lineHold pode possivelmente não colocar a chamada em espera, pois o status de outras estações na chamada pode controlar (por exemplo, tentar "segurar" uma chamada quando outras estações estão participando não é possível); em vez disso, a chamada pode simplesmente ser alterada para o modo LINECONNECTEDMODE_INACTIVE se ela permanecer conectada em outras estações.