Metodo ITBasicCallControl::Transfer (tapi3if.h)

Articolo
03/02/2024

Il metodo Transfer trasferisce la chiamata corrente all'indirizzo di destinazione.

Sintassi

HRESULT Transfer(
  [in] ITBasicCallControl *pCall,
  [in] VARIANT_BOOL       fSync
);

Parametri

[in] pCall

Puntatore all'interfaccia ITBasicCallControl della chiamata di consultazione creata per il trasferimento.

[in] fSync

Indica se il metodo deve essere completato in modo sincrono (VARIANT_TRUE) o in modo asincrono (VARIANT_FALSE).

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il parametro pCall non punta a una chiamata valida.
E_FAIL	Trasferimenti non supportati.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
TAPI_E_TIMEOUT	L'operazione non è riuscita perché la DLL TAPI 3 ha superato il timeout. L'intervallo di timeout è di due minuti.

Commenti

Alcuni provider di servizi non supportano questa operazione mentre lo streaming è attivo. L'applicazione potrebbe dover chiamare ITStream::StopStream o ITSubStream::StopSubStream prima dell'operazione e ITStream::StartStream o ITSubStream::StartSubStream dopo il completamento dell'operazione.

Il trasferimento delle chiamate prevede l'impostazione di una chiamata di consultazione in preparazione del trasferimento. pCall è il puntatore ITBasicCallControl restituito da ITAddress::CreateCall dopo la creazione di una chiamata di consultazione. ITBasicCallControl::Finish (FM_ASTRANSFER) completa il trasferimento.

Se la chiamata di consultazione non è nello stato CONNECTED quando viene chiamato Transfer , TAPI userà l'indirizzo di destinazione (come specificato quando la chiamata di consultazione è stata creata per la prima volta tramite ITAddress::CreateCall) e tenterà di connettersi in quel momento. Se la chiamata originale ha un indirizzo di destinazione NULL , Il trasferimento avrà esito negativo con E_INVALIDARG.