Constantes LINEDISCONNECTMODE_

As constantes LINEDISCONNECTMODE_ sinalizador de bits descrevem diferentes motivos para uma solicitação de desconexão remota. Um modo de desconexão está disponível como status de chamada para o aplicativo depois que o estado de chamada faz a transição para desconectado.

LINEDISCONNECTMODE_BADADDRESS

O endereço de destino é inválido.

LINEDISCONNECTMODE_BLOCKED

A chamada não pôde ser conectada porque as chamadas do endereço de origem não estão sendo aceitas no endereço de destino. Isso difere de LINEDISCONNECTMODE_REJECT em que o bloqueio é implementado na rede (uma rejeição passiva), enquanto uma rejeição é implementada no equipamento de destino (uma rejeição ativa). O bloqueio pode ser devido a uma exclusão específica do endereço de origem ou porque o destino aceita chamadas de apenas um conjunto selecionado de endereço de origem (grupo de usuários fechado). (Versões 2.0 e posteriores do TAPI)

LINEDISCONNECTMODE_BLOCKED é apropriado como uma resposta em lista de bloqueios. Por exemplo, um modem recebeu uma resposta, passou mais de seis segundos sem detectar Ringback, falhou ao conectar um número definido de vezes, determina que o número de telefone não é válido para chamar e emite uma resposta 'blocklisted'.

LINEDISCONNECTMODE_BUSY

A estação do usuário remoto está ocupada.

LINEDISCONNECTMODE_CANCELLED

A chamada foi cancelada. (Versões 2.0 e posteriores do TAPI)

LINEDISCONNECTMODE_CONGESTION

A rede está congestionada.

LINEDISCONNECTMODE_DONOTDISTURB

A chamada não pôde ser conectada porque o destino invocou o recurso Não Incomodar. (Versões 2.0 e posteriores do TAPI)

LINEDISCONNECTMODE_FORWARDED

A chamada foi encaminhada pela opção .

LINEDISCONNECTMODE_INCOMPATIBLE

O equipamento de estação do usuário remoto é incompatível com o tipo de chamada solicitada.

LINEDISCONNECTMODE_NOANSWER

A estação do usuário remoto não responde.

LINEDISCONNECTMODE_NODIALTONE

Um tom de discagem não foi detectado em um tempo limite definido pelo provedor de serviços, em um ponto durante a discagem quando era esperado (como em um "W" na cadeia de caracteres discável). Isso também pode ocorrer sem um período de tempo limite definido pelo provedor de serviços ou sem um valor especificado no membro dwWaitForDialTone da estrutura LINEDIALPARAMS . (Versões TAPI 1.4 e posteriores)

LINEDISCONNECTMODE_NORMAL

Essa é uma solicitação de desconexão normal da parte remota. A chamada foi encerrada normalmente.

LINEDISCONNECTMODE_NUMBERCHANGED

A chamada não pôde ser conectada porque o número de destino foi alterado, mas o redirecionamento automático para o novo número não é fornecido. (Versões 2.0 e posteriores do TAPI)

LINEDISCONNECTMODE_OUTOFORDER

A chamada não pôde ser conectada ou foi desconectada porque o dispositivo de destino está fora de ordem (falha de hardware). (Versões 2.0 e posteriores do TAPI)

LINEDISCONNECTMODE_PICKUP

A chamada foi atendida de outro lugar.

LINEDISCONNECTMODE_QOSUNAVAIL

A chamada não pôde ser conectada ou desconectada porque a qualidade mínima do serviço não pôde ser obtida ou sustentada. Isso difere de LINEDISCONNECTMODE_INCOMPATIBLE em que a falta de recursos pode ser uma condição temporária no destino. (Versões 2.0 e posteriores do TAPI)

LINEDISCONNECTMODE_REJECT

O usuário remoto rejeitou a chamada.

LINEDISCONNECTMODE_TEMPFAILURE

A chamada não pôde ser conectada ou foi desconectada devido a uma falha temporária na rede; a chamada pode ser reattempted mais tarde e espera-se que eventualmente seja concluída. (Versões 2.0 e posteriores do TAPI)

LINEDISCONNECTMODE_TEMPFAILURE é apropriado como uma resposta atrasada. Por exemplo, um modem recebendo um sinal ocupado ou equivalente muitas vezes em um determinado período de tempo conclui que o número não deve ser chamado novamente até que um tempo definido tenha decorrido e emita uma resposta "atrasada".

LINEDISCONNECTMODE_UNAVAIL

O motivo da desconexão não está disponível e não será conhecido posteriormente.

LINEDISCONNECTMODE_UNKNOWN

O motivo da solicitação de desconexão é desconhecido, mas pode se tornar conhecido posteriormente.

LINEDISCONNECTMODE_UNREACHABLE

Não foi possível acessar o usuário remoto.

Comentários

Os 16 bits de alta ordem podem ser atribuídos para extensões específicas do dispositivo. Os 16 bits de ordem baixa são reservados.

Uma solicitação de desconexão remota para uma determinada chamada resulta na transição do estado de chamada para o estado desconectado e uma mensagem LINE_CALLSTATE é enviada ao aplicativo. As informações de LINEDISCONNECTMODE_ fornecem detalhes sobre a solicitação de desconexão remota. Ela está disponível na estrutura LINECALLSTATUS da chamada quando a chamada está no estado desconectado. Enquanto uma chamada está nesse estado, o aplicativo ainda tem permissão para consultar as informações da chamada e status. Por exemplo, as informações de usuário-usuário recebidas como parte da desconexão remota estão disponíveis em seguida. O aplicativo pode limpar uma chamada desconectada removendo a chamada.

Para compatibilidade com versões anteriores, é responsabilidade do provedor de serviços examinar a versão da API negociada na linha e não usar esse valor LINEDISCONNECTMODE_ se não houver suporte na versão negociada (LINEDISCONNECTMODE_NORMAL ou _UNKNOWN poderia ser usado em vez disso).

Requisitos

Confira também

LINE_CALLSTATE

LINECALLSTATUS

LINEDIALPARAMS