função TSPI_lineDrop (tspi.h)

Artigo
03/03/2024

A função TSPI_lineDrop descarta ou desconecta a chamada especificada. Opcionalmente, as informações do usuário podem ser transmitidas como parte da desconexão da chamada. Essa função pode ser chamada pelo aplicativo a qualquer momento. Quando TSPI_lineDrop retorna, a chamada deve estar ociosa.

Sintaxe

LONG TSPIAPI TSPI_lineDrop(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador do provedor de serviços para a chamada a ser descartada. O estado de chamada de hdCall pode ser qualquer estado, exceto ocioso.

lpsUserUserInfo

Esse ponteiro só será válido se dwSize for diferente de zero. Ele especifica um ponteiro para uma cadeia de caracteres terminada em nulo que contém informações do usuário-usuário a serem enviadas à parte remota como parte da desconexão da chamada. Esse ponteiro será NULL se nenhuma informação de usuário deve ser enviada. As informações do usuário são enviadas somente se houver suporte da rede subjacente (consulte LINEDEVCAPS).

dwSize

O tamanho em bytes das informações de usuário-usuário em lpsUserUserInfo. Se lpsUserUserInfo for NULL, dwSize será ignorado.

Retornar valor

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_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Comentários

O provedor de serviços retornará LINEERR_INVALCALLSTATE se o estado atual da chamada não permitir que a chamada seja descartada.

Ao invocar TSPI_lineDrop, as chamadas relacionadas às vezes também podem ser afetadas. Por exemplo, descartar uma chamada em conferência pode descartar todas as chamadas participantes individuais. LINE_CALLSTATE mensagens são enviadas ao TAPI para todas as chamadas cujo estado de chamada é afetado. Normalmente, uma chamada descartada faz a transição para o estado ocioso . Invocar TSPI_lineDrop em uma chamada no estado de oferta rejeita a chamada. Nem todas as redes telefônicas fornecem essa funcionalidade.

Em situações em que a chamada a ser descartada é uma chamada de consulta estabelecida durante a transferência ou o estabelecimento da chamada em conferência, a chamada original que foi colocada no estado OnHoldPending é reconectada e normalmente entra novamente no estado de chamada conectada .

O TAPI tem a opção de enviar informações de usuário-usuário no momento da remoção. Mesmo que as informações do usuário-usuário possam ser enviadas, não há nenhuma garantia de que a rede fornecerá essas informações à parte remota.

Nota Em várias configurações de linha de ponte ou de terceiros quando várias partes estão na chamada, TSPI_lineDrop pode realmente não limpar a chamada.