Функция phoneSetStatusMessages (tapi.h)
Функция phoneSetStatusMessages позволяет приложению отслеживать выбранные события состояния на указанном телефонном устройстве.
Синтаксис
LONG phoneSetStatusMessages(
HPHONE hPhone,
DWORD dwPhoneStates,
DWORD dwButtonModes,
DWORD dwButtonStates
);
Параметры
hPhone
Обработка для отслеживания открытого телефонного устройства.
dwPhoneStates
Набор изменений состояния телефона и событий, для которых приложение может получать уведомления. Этот параметр может иметь ноль, одну или несколько констант PHONESTATE_.
dwButtonModes
Набор режимов кнопок телефона, для которых приложение может получать уведомления. Этот параметр может иметь ноль, одну или несколько констант PHONEBUTTONMODE_.
dwButtonStates
Набор изменений состояния кнопки телефона, для которых приложение может получать уведомления. Если параметр dwButtonModes равен нулю, dwButtonStates игнорируется. Если dwButtonModes имеет один или несколько битов, этот параметр также должен иметь по крайней мере один бит. Этот параметр использует константы PHONEBUTTONSTATE_.
Возвращаемое значение
Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE, PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL.
Комментарии
Приложение может использовать функцию phoneSetStatusMessages для включения или отключения создания соответствующих сообщений. Все сообщения о состоянии телефона отключены по умолчанию.
Требования
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |