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

Статья
08/26/2023

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

Синтаксис

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

Параметры

hLine

Дескриптор на линейное устройство.

dwLineStates

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

dwAddressStates

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

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

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

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

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