Função lineBlindTransfer (tapi.h)

Artigo
08/26/2023

A função lineBlindTransfer executa uma transferência cega ou em etapa única da chamada especificada para o endereço de destino especificado.

Sintaxe

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

Parâmetros

hCall

Manipule para a chamada a ser transferida. O aplicativo deve ser um proprietário dessa chamada. O estado de chamada de hCall deve estar conectado.

lpszDestAddress

TBD

dwCountryCode

Código de país ou região do destino. Isso é usado pela implementação para selecionar os protocolos de progresso da chamada para o endereço de destino. Se um valor de 0 for especificado, um protocolo de progresso de chamada padrão definido pelo provedor de serviços será usado.

Valor retornado

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

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

Comentários

Se LINEERR_INVALADDRESS for retornado, nenhuma discagem ocorrerá.

A transferência às cegas difere de uma transferência de consulta, uma vez que nenhuma chamada de consulta se torna visível para o aplicativo. Após a conclusão da transferência cega com êxito, a chamada especificada normalmente é limpa da linha do aplicativo e faz a transição para o estado ocioso .

O identificador de chamada do aplicativo permanece válido após a conclusão da transferência. O aplicativo deve desalocar seu identificador usando lineDeallocateCall quando não estiver mais interessado na chamada transferida.