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

Функция phoneGetButtonInfo возвращает сведения об указанной кнопке.

Синтаксис

LONG phoneGetButtonInfo(
  HPHONE            hPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

Параметры

hPhone

Дескриптор на открытое телефонное устройство.

dwButtonLampID

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

lpButtonInfo

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

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

Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

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

Требования

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

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

PHONEBUTTONINFO

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

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