Метод ITBasicCallControl::HandoffDirect (tapi3if.h)

Статья
03/09/2024

Метод HandoffDirect передает вызов другому приложению. Это означает, что приложению больше не требуется владение вызовом.

Синтаксис

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

Параметры

[in] pApplicationName

Указатель на BSTR , содержащий конкретное имя приложения для передачи вызова. Может быть полным именем пути или именем исполняемого файла.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Метод успешно выполнен.
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.
E_POINTER	Параметр pApplicationName не является допустимым указателем.

Некоторые поставщики услуг не поддерживают эту операцию, пока потоковая передача активна. Приложению может потребоваться вызвать ITStream::StopStream или ITSubStream::StopSubStream перед операцией и ITStream::StartStream или ITSubStream::StartSubStream после завершения операции.

Если принимающее приложение не открыло строку для типов мультимедиа, участвующих в вызове, передача завершится ошибкой. Если TAPI не удается передать вызов, TAPI вызовет отключение.

Приложение должно использовать SysAllocString для выделения памяти для параметра pApplicationName и использовать SysFreeString , чтобы освободить память, когда переменная больше не нужна.