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

Статья
03/02/2024

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

Синтаксис

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

Параметры

hLine

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

dwAddressID

Адрес на данном устройстве с открытой линией. Это адрес для запроса. Идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы.

lpAddressStatus

Указатель на структуру данных изменчивого размера типа LINEADDRESSSTATUS. Перед вызовом lineGetAddressStatus приложение должно задать элемент dwTotalSize этой структуры, чтобы указать объем памяти, доступной TAPI для возврата информации.

Примечание Если параметры размера в структуре неверны, существует вероятность того, что данные могут быть перезаписаны. Дополнительные сведения о настройке размеров структуры см. в разделе о выделении памяти .

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

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

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

Требования

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

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

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

LINEADDRESSSTATUS

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

Поделиться через