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

Статья
08/26/2023

Функция 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 для включения или отключения создания соответствующих сообщений. Все сообщения о состоянии телефона отключены по умолчанию.