Metodo ITBasicCallControl::P arkDirect (tapi3if.h)

Articolo
08/26/2023

Il metodo ParkDirect parcheggia la chiamata a un indirizzo specificato.

Sintassi

HRESULT ParkDirect(
  [in] BSTR pParkAddress
);

Parametri

[in] pParkAddress

Puntatore a BSTR contenente l'indirizzo in cui deve essere parcheggiata la chiamata.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro pParkAddress non è un puntatore valido.
E_FAIL	Il parco non è supportato.
E_INVALIDARG	Il parametro pParkAddress non è valido.
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.

Con il parcheggio diretto, l'applicazione determina l'indirizzo in cui vuole parcheggiare la chiamata. Con ParkInDirect, l'opzione determina l'indirizzo e lo fornisce all'applicazione. In entrambi i casi, una chiamata parcheggiata può essere scaricata specificando questo indirizzo.

La chiamata parcheggiata entra nello stato disconnesso dopo che è stato parcheggiato correttamente.

Alcuni commutatori possono ricordare all'utente dopo che una chiamata è stata parcheggiata per un lungo periodo di tempo. L'applicazione vede una chiamata di offerta con un motivo di chiamata impostato su promemoria.

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