функция tapiRequestMakeCallW (tapi.h)

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

Синтаксис

LONG tapiRequestMakeCallW(
  LPCWSTR lpszDestAddress,
  LPCWSTR lpszAppName,
  LPCWSTR lpszCalledParty,
  LPCWSTR lpszComment
);

Параметры

lpszDestAddress

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

lpszAppName

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

lpszCalledParty

Указатель на расположение памяти, в котором находится null-завершенное имя участника для вызываемой стороны вызова. Этот указатель можно оставить 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.

Заметка

Заголовок tapi.h определяет tapiRequestMakeCall как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

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

Обзор TAPI 2.2