функция TSPI_lineSetStatusMessages (tspi.h)

Статья
03/09/2024

Функция TSPI_lineSetStatusMessages позволяет TAPI указать, какие уведомления должны создаваться поставщиком услуг для событий, связанных с изменением состояния для указанной строки или любого из ее адресов.

Синтаксис

LONG TSPIAPI TSPI_lineSetStatusMessages(
  HDRVLINE hdLine,
  DWORD    dwLineStates,
  DWORD    dwAddressStates
);

Параметры

hdLine

Дескриптор устройства линии, для которого должен быть задан новый фильтр.

dwLineStates

Битовый массив, определяющий, для какого состояния устройства линии изменяется сообщение, отправляется в TAPI. Этот параметр использует одну из констант LINEDEVSTATE_.

dwAddressStates

Битовый массив, определяющий, для какого адреса изменяется состояние сообщения, отправляется в TAPI. Этот параметр использует одну из констант LINEADDRESSSTATE_.

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

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

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINESTATE, LINEERR_RESOURCEUNAVAIL LINEERR_NOMEM.

Телефония определяет ряд сообщений, уведомляющих приложения о событиях, происходящих на строках и адресах. Наборы всех сообщений об изменениях, в которых заинтересованы все приложения, могут быть гораздо меньше, чем набор возможных сообщений. Эта процедура позволяет TAPI сообщить поставщику услуг о ограниченном наборе сообщений для доставки. Поставщик услуг доставляет все поддерживаемые сообщения в пределах указанного набора. Разрешено предоставлять больше (они фильтруются с помощью TAPI), но не рекомендуется делать это по соображениям производительности. Если TAPI запрашивает доставку сообщения определенного типа, не созданного поставщиком, поставщик тем не менее принимает запрос, но просто не создает сообщение. По умолчанию отчеты о состоянии адресов и строк изначально отключены для строки.

Эта функция отличается от соответствующей функции TAPI следующим образом: (1) Запрошенный набор сообщений представляет собой объединение всех наборов, запрашиваемых приложениями на уровне TAPI. (2) Набор сообщений не уменьшается и не дополняется владением (поскольку на уровне TSPI отсутствует концепция владения) (3) Набор рекомендуется в том смысле, что поставщик услуг должен пересылать по крайней мере указанный набор сообщений, но может пересылать больший набор.

Об изменениях состояния устройства в отношении открытия и закрытия не сообщается, так как на уровне TSPI одновременно существует только один открытый открытый.