Método ITBasicCallControl::BlindTransfer (tapi3if.h)

Artigo
03/05/2024

O método BlindTransfer executa uma transferência cega ou em etapa única da chamada especificada para o endereço de destino especificado. O aplicativo deve ser o proprietário da chamada. Após uma transferência bem-sucedida, o estado de chamada faz a transição para CS_DISCONNECTED.

Sintaxe

HRESULT BlindTransfer(
  [in] BSTR pDestAddress
);

Parâmetros

[in] pDestAddress

Ponteiro para BSTR que contém o endereço de destino da transferência.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O pDestAddress não é um ponteiro válido.
E_FAIL	Não há suporte para transferência cega.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
TAPI_E_TIMEOUT	A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos.

Comentários

Alguns provedores de serviços não dão suporte a essa operação enquanto o streaming está ativo. O aplicativo pode precisar chamar ITStream::StopStream ou ITSubStream::StopSubStream antes da operação e ITStream::StartStream ou ITSubStream::StartSubStream após a conclusão da operação.

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pDestAddress e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

Em alguns casos, o aplicativo pode precisar usar as interfaces de tradução de endereço ( ITAddressTranslation e ITAddressTranslationInfo) para obter uma cadeia de caracteres pDestAddress no formato adequado.