Функция lineSetStatusMessages (tapi.h)
Функция 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 может использоваться для выбора сообщений, получаемых приложением. По умолчанию отчеты о состоянии адресов и строк отключены.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |