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

Статья
08/26/2023

Функция phoneSetButtonInfo задает сведения о указанной кнопке на указанном телефоне.

Синтаксис

LONG phoneSetButtonInfo(
  HPHONE                  hPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Параметры

hPhone

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

dwButtonLampID

Кнопка на телефонном устройстве.

lpButtonInfo

Указатель на структуру изменчивого размера типа PHONEBUTTONINFO. Эта структура данных описывает режим, функцию и предоставляет дополнительный описательный текст о кнопке.

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

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

PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONEHANDLE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL PHONEERR_RESOURCEUNAVAIL.