Condividi tramite


Metodo ITBasicCallControl::HandoffDirect (tapi3if.h)

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.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi3if.h (includere Tapi3.h)
Libreria Uuid.lib
DLL Tapi3.dll

Vedi anche

Oggetto Call

Disconnetti

Panoramica dei handoff

ITBasicCallControl

lineHandoff