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

Статья
08/26/2023

Метод Dial набирает указанный адрес.

Синтаксис

HRESULT Dial(
  [in] BSTR pDestAddress
);

Параметры

[in] pDestAddress

Указатель на BSTR-представление адреса для набора. Формат должен соответствовать стандартному набираемому адресу.

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

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

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

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

В некоторых случаях приложению может потребоваться использовать интерфейсы преобразования адресов ( ITAddressTranslation и ITAddressTranslationInfo), чтобы получить строку pDestAddress в правильном формате.

Метод Dial отличается от ITAddress::CreateCall тем, что вызов уже существует. Примером использования является набор расширений.