Freigeben über


ITBasicCallControl::HandoffDirect-Methode (tapi3if.h)

Die HandoffDirect-Methode gibt den Aufruf an eine andere Anwendung ab. Dies gibt an, dass die Anwendung den Besitz des Aufrufs nicht mehr benötigt.

Syntax

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

Parameter

[in] pApplicationName

Zeiger auf BSTR , der den spezifischen Anwendungsnamen enthält, an den der Aufruf übergeben werden soll. Kann der vollständige Pfadname oder der Name der ausführbaren Datei sein.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Methode war erfolgreich.
E_OUTOFMEMORY
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
E_POINTER
Der pApplicationName-Parameter ist kein gültiger Zeiger.

Hinweise

Einige Dienstanbieter unterstützen diesen Vorgang nicht, während das Streaming aktiv ist. Die Anwendung muss möglicherweise ITStream::StopStream oder ITSubStream::StopSubStream vor dem Vorgang und ITStream::StartStream oder ITSubStream::StartSubStream nach Abschluss des Vorgangs aufrufen.

Wenn die empfangende Anwendung die Zeile für die am Aufruf beteiligten Medientypen nicht geöffnet hat, schlägt die Übergabe fehl. Wenn TAPI den Anruf nicht übergeben kann, ruft TAPI Disconnect auf.

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pApplicationName-Parameter zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (einschließlich Tapi3.h)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

Objekt aufrufen

Disconnect (Trennen)

Übersicht über Übergaben

ITBasicCallControl

lineHandoff