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

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

Синтаксис

LONG lineGetLineDevStatusW(
  HLINE           hLine,
  LPLINEDEVSTATUS lpLineDevStatus
);

Параметры

hLine

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

lpLineDevStatus

Указатель на структуру данных изменчивого размера типа LINEDEVSTATUS. После успешного выполнения запроса эта структура заполняется состоянием устройства строки. Перед вызовом lineGetLineDevStatus приложение должно задать член dwTotalSize этой структуры, чтобы указать объем памяти, доступной ДЛЯ TAPI для возврата сведений.

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

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

LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED LINEERR_OPERATIONUNAVAIL.

Комментарии

Приложение использует lineGetLineDevStatus для запроса текущего состояния строки у устройства линии. Эти сведения о состоянии применяются глобально ко всем адресам на устройстве линии. Используйте lineGetAddressStatus для определения сведений о состоянии определенного адреса в строке.

Требования

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

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

Справочник по базовым службам телефонии

LINEDEVSTATUS

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

lineGetAddressStatus