função TSPI_lineBlindTransfer (tspi.h)

Artigo
03/03/2024

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

Sintaxe

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

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador do provedor de serviços para a chamada a ser transferida. O estado de chamada do hdCall pode ser conectado.

lpszDestAddress

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que identifica para onde a chamada deve ser transferida. O endereço de destino usa o formato de número discável padrão.

dwCountryCode

O código de país ou região do destino. A implementação deve usar isso para selecionar os protocolos de progresso da chamada para o endereço de destino. Se um valor de 0 for especificado, o provedor de serviços deverá usar um padrão. TAPI não valida dwCountryCode 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_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_ADDRESSBLOCKED, LINEERR_RESOURCEUNAVAIL LINEERR_INVALCOUNTRYCODE.

Comentários

O provedor de serviços não executará nenhuma discagem se retornar LINEERR_INVALADDRESS.

A transferência cega difere de uma transferência de consulta, uma vez que nenhuma chamada de consulta se torna visível para a TAPI. Normalmente, depois que a transferência cega é concluída com êxito, a chamada especificada é limpa da linha em que estava e faz a transição para o estado ocioso . O identificador de chamada do provedor de serviços deve permanecer válido após a conclusão da transferência. O TAPI faz com que esse identificador seja invalidado quando ele não estiver mais interessado na chamada transferida usando TSPI_lineCloseCall.