Функция lineGetStatusMessages (tapi.h)
Функция lineGetStatusMessages позволяет приложению запрашивать, какие уведомления приложение настроено для получения событий, связанных с изменениями состояния для указанной строки или любого из ее адресов.
Синтаксис
LONG lineGetStatusMessages(
HLINE hLine,
LPDWORD lpdwLineStates,
LPDWORD lpdwAddressStates
);
Параметры
hLine
Дескриптор для устройства линии.
lpdwLineStates
Битовый массив, определяющий, для какого состояния устройства линии изменяется сообщение, должно быть отправлено в приложение. Если флаг имеет значение TRUE, это сообщение включено; Значение false, оно отключено. Этот параметр использует одну или несколько констант LINEDEVSTATE_.
lpdwAddressStates
Битовый массив, определяющий, для какого адреса изменяется состояние сообщения, отправляется в приложение. Если флаг имеет значение TRUE, это сообщение включено; Значение false, отключено. Этот параметр использует одну или несколько констант LINEADDRESSSTATE_.
Возвращаемое значение
Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM LINEERR_UNINITIALIZED.
Комментарии
TAPI определяет ряд сообщений, уведомляющих приложения о событиях, происходящих в строках и адресах. Приложение может быть не заинтересовано в получении всех сообщений об изменении адреса и строки. Функцию lineSetStatusMessages можно использовать для выбора сообщений, которые приложение хочет получать. По умолчанию отчеты о состоянии адресов и строк отключены.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |