Функция tapiRequestMakeCall (tapi.h)
Функция 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 |