ITBasicCallControl::HandoffDirect-Methode (tapi3if.h)

Artikel
08/26/2023

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.