Функция phoneGetStatusMessages (tapi.h)
Функция phoneGetStatusMessages возвращает изменения состояния телефона на указанном телефонном устройстве, создающие обратный вызов к приложению.
Синтаксис
LONG phoneGetStatusMessages(
HPHONE hPhone,
LPDWORD lpdwPhoneStates,
LPDWORD lpdwButtonModes,
LPDWORD lpdwButtonStates
);
Параметры
hPhone
Дескриптор для отслеживания открытого телефонного устройства.
lpdwPhoneStates
Указатель на DWORD , содержащий ноль, одну или несколько констант PHONESTATE_. Эти флаги указывают набор изменений состояния телефона и событий, для которых приложение может получать уведомления. Мониторинг можно включить и отключить по отдельности.
lpdwButtonModes
Указатель на DWORD , содержащий флаги, указывающие набор режимов кнопок телефона, для которых приложение может получать уведомления. Этот параметр использует ноль, одну или несколько констант PHONEBUTTONMODE_.
lpdwButtonStates
Указатель на DWORD , содержащий флаги, указывающие набор изменений состояния кнопки телефона, для которых приложение может получать уведомления. Этот параметр использует ноль, одну или несколько констант PHONEBUTTONSTATE_.
Возвращаемое значение
Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED PHONEERR_UNINITIALIZED.
Комментарии
Приложение может использовать phoneGetStatusMessages для запроса создания соответствующих сообщений. Создание сообщений можно контролировать с помощью phoneGetStatusMessages. Все сообщения о состоянии телефона по умолчанию отключены.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |