функция phoneGetButtonInfoA (tapi.h)

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

Синтаксис

LONG phoneGetButtonInfoA(
  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.

Замечания

Заметка

Заголовок tapi.h определяет phoneGetButtonInfo как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

PHONEBUTTONINFO

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

Обзор TAPI 2.2