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 |
|---|---|
|
Il metodo è riuscito. |
|
Memoria insufficiente per eseguire l'operazione. |
|
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 |