função TSPI_lineHold (tspi.h)

Artigo
08/26/2023

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

Sintaxe

LONG TSPIAPI TSPI_lineHold(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador do provedor de serviços para a chamada a ser colocada em espera. O estado de chamada do hdCall pode ser conectado.

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 possíveis valores retornados são os seguintes:

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

Comentários

A chamada em espera está temporariamente desconectada, permitindo que a TAPI use o dispositivo de linha para fazer ou atender outras chamadas. TSPI_lineHold executa um 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, enquanto uma chamada de consulta pode. As chamadas de consulta são iniciadas usando TSPI_lineSetupTransfer, TSPI_lineSetupConference ou TSPI_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 meio de TSPI_lineUnhold. Enquanto uma chamada está em espera, o provedor de serviços pode enviar 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 e o provedor de serviços poderá enviar uma mensagem LINE_CALLSTATE indicando o novo estado.