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

Статья
03/02/2024

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

Синтаксис

LONG lineGetLineDevStatus(
  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 для определения сведений о состоянии определенного адреса в строке.