Функция phoneSetButtonInfo (tapi.h)
Функция 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.
Требования
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |