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

Статья
03/08/2023

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

Синтаксис

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

Параметры

hLineApp

Дескриптор использования приложения для части строки TAPI.

dwRegistrationInstance

DWORD для конкретного приложения, который передается обратно в качестве параметра сообщения LINE_REQUEST. Это сообщение уведомляет приложение о том, что запрос находится в состоянии ожидания. Этот параметр игнорируется, если параметр bEnable имеет нулевое значение. Этот параметр проверяется TAPI только для регистрации, а не для отмены регистрации. Значение dwRegistrationInstance, используемое при отмене регистрации, не обязательно совпадает с параметром dwRegistrationInstance , используемым при регистрации в режиме запроса.

dwRequestMode

Тип запроса, для которого регистрируется приложение. Этот параметр использует одну или несколько констант LINEREQUESTMODE_.

bEnable

Если задано значение TRUE, приложение регистрирует указанные режимы запросов; значение FALSE, приложение отменяет регистрацию для указанных режимов запроса.

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

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

LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM LINEERR_UNINITIALIZED.

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

Затем приложение для управления вызовами, которое получает это сообщение, вызывает lineGetRequest, указывая режим запроса и буфер, достаточно большой для хранения запроса. Затем приложение для управления вызовами интерпретирует и выполняет запрос.

Приложение-получатель также автоматически отменяется для всех запросов при выполнении lineShutdown.