Метод ITAddress::Forward (tapi3if.h)

Статья
08/26/2023

Метод Forward пересылает вызовы, предназначенные для адреса, в соответствии с инструкциями по пересылке, содержащимися в ITForwardInformation. Если параметр pForwardInfo имеет значение NULL, пересылка отменяется.

Синтаксис

HRESULT Forward(
  [in] ITForwardInformation *pForwardInfo,
  [in] ITBasicCallControl   *pCall
);

Параметры

[in] pForwardInfo

Указатель на интерфейс ITForwardInformation или значение NULL для отмены пересылки.

[in] pCall

Указатель на интерфейс ITBasicCallControl для вызова консультации, если это требуется в среде телефонии. Если это не требуется, может иметь значение NULL .

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

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

Код возврата	Описание
S_OK	Метод успешно выполнен.
E_INVALIDARG	Адрес не поддерживает переадресацию, или pCall не указывает на допустимый вызов.
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.
E_POINTER	Параметр pForwardInfo или pCall не является допустимым указателем.
TAPI_E_TIMEOUT	Операция завершилась сбоем, так как время ожидания библиотеки DLL TAPI 3 истекло. Интервал времени ожидания составляет две минуты.
LINEERR_	Коды ошибок, возвращаемые этой функцией TAPI 2.1, см. в разделе LineForward .

Приложение может определить, требуется ли вызов консультации, отличный от NULL , путем вызова ITAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS, plCapability) и проверки того, установлен ли флаг LINEADDRCAPFLAGS_FWDCONSULT, член LINEADDRCAPFLAGS_ Constants, в plCapability. Если он задан, для параметра pCall метода Forward требуется значение, отличное от NULL.

Метод Forward частично является COM-оболочкой для функции TAPI 2.1 LineForward .