Função lineBlindTransferA (tapi.h)

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

Sintaxe

LONG lineBlindTransferA(
  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 ser 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 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_INVALCALLHANDLE, LINEERR_INVALCOUNTRYCODE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_ADDRESSBLOCKED, LINEERR_OPERATIONFAILED.

Observações

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 fica visível para o aplicativo. Depois que a transferência cega for concluída com êxito, a chamada especificada normalmente será desmarcada da linha do aplicativo e ela fará 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.

Nota

O cabeçalho tapi.h define lineBlindTransfer 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

Funções de serviço de linha suplementar

visão geral de referência do TAPI 2.2

Visão geral da transferência de

lineDeallocateCall