Поделиться через


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

Функция phoneSetLamp приводит к тому, что указанная лампа горит на указанном открытом телефонном устройстве в указанном режиме лампы.

Синтаксис

LONG phoneSetLamp(
  HPHONE hPhone,
  DWORD  dwButtonLampID,
  DWORD  dwLampMode
);

Параметры

hPhone

Дескриптор на открытое телефонное устройство. Приложение должно быть владельцем телефона.

dwButtonLampID

Кнопка, на которой должна быть освещена лампа.

dwLampMode

Как должна быть освещена лампа. Этот параметр использует только одну из констант PHONELAMPMODE_.

Возвращаемое значение

Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр dwParam2 соответствующего сообщения PHONE_REPLY равен нулю при успешном выполнении функции или отрицательным номером ошибки при возникновении ошибки. Возможные возвращаемые значения:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALLAMPMODE PHONEERR_UNINITIALIZED.

Требования

Требование Значение
Целевая платформа Windows
Header tapi.h
Библиотека Tapi32.lib
DLL Tapi32.dll

См. также раздел

PHONE_REPLY

Дополнительные функции телефонной службы

Обзор справочника по TAPI 2.2