Função lineRedirect (tapi.h)

Artigo
03/02/2024

A função lineRedirect redireciona a chamada de oferta especificada para o endereço de destino especificado.

Sintaxe

LONG lineRedirect(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Parâmetros

hCall

Manipule para a chamada a ser redirecionada. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall deve estar oferecendo.

lpszDestAddress

Ponteiro para o endereço de destino. Isso segue o formato de número discável padrão.

dwCountryCode

Código de país/região da parte para a qual a chamada é redirecionada. Se um valor de 0 for especificado, um padrão será usado pela implementação.

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

LINEERR_INVALADDRESS, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Comentários

O redirecionamento de chamadas permite que um aplicativo desvie uma chamada de oferta para outro endereço sem primeiro atender à chamada. O redirecionamento de chamadas difere do encaminhamento de chamadas em que o encaminhamento de chamadas é executado pela opção sem o envolvimento do aplicativo; O redirecionamento pode ser feito por chamada pelo aplicativo, por exemplo, orientado por informações de ID do chamador. Ela difere da transferência de chamada, pois a transferência de uma chamada exige que a chamada seja atendida primeiro.

Depois que uma chamada é redirecionada com êxito, a chamada normalmente faz a transição para ociosa.

Além de redirecionar uma chamada de entrada, um aplicativo pode ter a opção de aceitar a chamada usando lineAccept, rejeitar a chamada usando lineDrop ou atender a chamada usando lineAnswer. A disponibilidade dessas operações depende dos recursos do dispositivo.