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

Статья
08/26/2023

Метод ParkDirect паркует вызов по указанному адресу.

Синтаксис

HRESULT ParkDirect(
  [in] BSTR pParkAddress
);

Параметры

[in] pParkAddress

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

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

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

Код возврата	Описание
S_OK	Метод успешно выполнен.
E_POINTER	Параметр pParkAddress не является допустимым указателем.
E_FAIL	Парк не поддерживается.
E_INVALIDARG	Недопустимый параметр pParkAddress .
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.
TAPI_E_TIMEOUT	Операция завершилась сбоем, так как время ожидания библиотеки DLL TAPI 3 истекло. Интервал времени ожидания составляет две минуты.

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

С помощью направленной парковки приложение определяет адрес, по которому оно хочет припарковать звонок. При использовании ParkInDirect параметр определяет адрес и предоставляет его приложению. В любом случае припаркованный вызов можно отменить, указав этот адрес.

После успешной парковки припаркованный вызов переходит в отключенное состояние.

Некоторые переключатели могут напоминать пользователю о том, что звонок был припаркован в течение длительного времени. Приложение видит звонок с предложением с причиной вызова, заданной как напоминание.

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