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

Функция phoneGetStatus позволяет приложению запрашивать у указанного открытого телефонного устройства его общее состояние.

Синтаксис

LONG phoneGetStatus(
  HPHONE        hPhone,
  LPPHONESTATUS lpPhoneStatus
);

Параметры

hPhone

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

lpPhoneStatus

Указатель на структуру данных изменчивого размера типа PHONESTATUS, которая загружается с возвращаемыми сведениями о состоянии телефона.

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

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

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

Комментарии

Приложение может использовать эту функцию для определения текущего состояния открытого телефонного устройства. Сведения о состоянии описывают сведения о устройствах-перехватчиках, звонках, громкости, дисплеях и лампах телефонного устройства.

Требования

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

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

PHONESTATUS

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

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