Metodo ITBasicCallControl::BlindTransfer (tapi3if.h)

Articolo
03/08/2023

Il metodo BlindTransfer esegue un trasferimento cieco o a passaggio singolo della chiamata specificata all'indirizzo di destinazione specificato. L'applicazione deve essere il proprietario della chiamata. Dopo il trasferimento, lo stato della chiamata passa a CS_DISCONNECTED.

Sintassi

HRESULT BlindTransfer(
  [in] BSTR pDestAddress
);

Parametri

[in] pDestAddress

Puntatore a BSTR contenente l'indirizzo di destinazione per il trasferimento.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	PDestAddress non è un puntatore valido.
E_FAIL	Il trasferimento cieco non è supportato.
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.

L'applicazione deve usare SysAllocString per allocare memoria per il parametro pDestAddress e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

In alcuni casi, l'applicazione potrebbe dover usare le interfacce di conversione degli indirizzi ( ITAddressTranslation e ITAddressTranslationInfo) per ottenere una stringa pDestAddress nel formato corretto.