função TSPI_lineRedirect (tspi.h)

Artigo
03/13/2024

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

Sintaxe

LONG TSPIAPI TSPI_lineRedirect(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador para a chamada a ser redirecionada. O estado de chamada do hdCall pode estar oferecendo.

lpszDestAddress

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o endereço de destino. Isso segue o formato de link padrão.

dwCountryCode

O código de país ou 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. Esse parâmetro não é validado pelo TAPI quando essa função é chamada.

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_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCOUNTRYCODE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.

Comentários

O provedor de serviços não redirecionará a chamada se retornar LINEERR_INVALADDRESS.

Quando essa função é invocada, o provedor de serviços desvia a 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 da estação chamada; O redirecionamento pode ser feito por chamada por aplicativo cliente, por exemplo, controlado por informações de ID do chamador. Ela difere da transferência de chamada, pois transferir uma chamada requer que a chamada seja atendida primeiro.

Depois que uma chamada é redirecionada com êxito, a chamada normalmente faz a transição para ociosa. O provedor de serviços indica o novo estado usando uma mensagem LINE_CALLSTATE .