Функция tapiRequestMakeCall (tapi.h)

Статья
03/05/2024

Функция tapiRequestMakeCall запрашивает создание голосового вызова. Приложение диспетчера вызовов отвечает за установку вызова от имени запрашивающего приложения, которое затем управляется приложением диспетчера вызовов пользователя.

Синтаксис

LONG tapiRequestMakeCall(
  LPCSTR lpszDestAddress,
  LPCSTR lpszAppName,
  LPCSTR lpszCalledParty,
  LPCSTR lpszComment
);

Параметры

lpszDestAddress

Указатель на расположение памяти, где находится конечный адрес запроса вызова, завершающийся null. Адрес может использовать канонический формат адреса . Допустимость указанного адреса не проверяется данной операцией. Максимальная длина адреса — символы TAPIMAXDESTADDRESSSIZE, включая признак конца NULL .

lpszAppName

Указатель на расположение памяти, где находится понятное для пользователя имя приложения запроса на вызов, завершающееся null. Этот указатель можно оставить пустым, если приложение не предоставляет имя приложения. Максимальная длина адреса — символы TAPIMAXAPPNAMESIZE, включая признак конца NULL . Более длинные строки усекаются.

lpszCalledParty

Указатель на расположение памяти, где находится имя вызываемой стороны, завершаемой null, для вызываемой стороны вызова. Этот указатель можно оставить пустым, если приложение не хочет предоставлять эти сведения. Максимальная длина строки — символы TAPIMAXCALLEDPARTYSIZE, включая признак конца NULL . Более длинные строки усекаются.

lpszComment

Указатель на расположение памяти, в котором находится комментарий о вызове, завершающийся значением NULL. Этот указатель можно оставить null , если приложение не предоставляет комментарий. Максимальная длина адреса — символы TAPIMAXCOMMENTSIZE, включая признак конца NULL . Более длинные строки усекаются.

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

Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения ошибки:

TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL TAPIERR_INVALPOINTER.

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

Вызов tapiRequestMakeCall при отсутствии запущенного приложения управления вызовами возвращает TAPIERR_NOREQUESTRECIPIENT сообщение об ошибке. Если приложение управления вызовами не запущено, TAPI пытается запустить приложение управления вызовами с наивысшим приоритетом (которое указано в реестре для RequestMakeCall ). Вызов этой функции при заполнении очереди запросов TAPI с поддержкой возвращает ошибку TAPIERR_REQUESTQUEUEFULL.

Требования

Требование	Значение
Целевая платформа	Windows
Header	tapi.h
Библиотека	Tapi32.lib
DLL	Tapi32.dll

См. также раздел

Справочник по вспомогательным службам телефонии

Обзор справочника по TAPI 2.2

Поделиться через