Função lineRedirectA (tapi.h)

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

Sintaxe

LONG lineRedirectA(
  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 ser 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 à qual a chamada é redirecionada. Se um valor de 0 for especificado, um padrão será usado pela implementação.

Valor de retorno

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 LINE_REPLY correspondente é 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_INVALADDRESS, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Observações

O redirecionamento de chamadas permite que um aplicativo desvie uma chamada de oferta para outro endereço sem atender primeiro à chamada. O redirecionamento de chamada é diferente 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 por chamada pelo aplicativo, por exemplo, controlado por informações de ID do chamador. Ela difere da transferência de chamada, pois a transferência de uma chamada requer que a chamada seja atendida primeiro.

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

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.

Nota

O cabeçalho tapi.h define lineRedirect como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

LINE_REPLY

visão geral de redirecionamento

Funções de serviço de linha suplementar

visão geral de referência do TAPI 2.2

lineAccept

lineAnswer

lineDrop