Metodo ITBasicCallControl::HandoffDirect (tapi3if.h)

Articolo
03/05/2024

Il metodo HandoffDirect disattiva la chiamata a un'altra applicazione. Ciò indica che l'applicazione non richiede più la proprietà della chiamata.

Sintassi

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

Parametri

[in] pApplicationName

Puntatore a BSTR contenente il nome dell'applicazione specifico a cui passare la chiamata. Può essere il nome completo del percorso o il nome eseguibile.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_POINTER	Il parametro pApplicationName non è un puntatore valido.

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.

Se l'applicazione di ricezione non ha aperto la riga per i tipi di supporti coinvolti nella chiamata, l'handoff avrà esito negativo. Se TAPI non riesce a disattivare la chiamata, TAPI chiamerà Disconnessione.

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