Структура LINEADDRESSSTATUS (tapi.h)

Статья
03/02/2024

Структура LINEADDRESSSTATUS описывает текущее состояние адреса. Функция lineGetAddressStatus и функция TSPI_lineGetAddressStatus возвращают структуру LINEADDRESSSTATUS .

Синтаксис

typedef struct lineaddressstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumInUse;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwAddressFeatures;
  DWORD dwNumRingsNoAnswer;
  DWORD dwForwardNumEntries;
  DWORD dwForwardSize;
  DWORD dwForwardOffset;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
} LINEADDRESSSTATUS, *LPLINEADDRESSSTATUS;

Члены

dwTotalSize

Общий размер, выделенный для этой структуры данных, в байтах.

dwNeededSize

Размер этой структуры данных, необходимый для хранения всей возвращаемой информации, в байтах.

dwUsedSize

Размер части этой структуры данных, содержащей полезную информацию, в байтах.

dwNumInUse

Количество станций, которые в настоящее время используют адрес.

dwNumActiveCalls

Количество вызовов по адресу, которые находятся в состояниях вызова, отличных от состояния простоя, onhold, onholdpendingtransfer и onholdpendingconference.

dwNumOnHoldCalls

Количество вызовов по адресу в состоянии удержания .

dwNumOnHoldPendCalls

Количество вызовов по адресу в состоянии onholdpendingtransfer или onholdpendingconference .

dwAddressFeatures

Связанные с адресом функции, которые могут вызываться для адреса в его текущем состоянии. Этот элемент использует одну или несколько констант LINEADDRFEATURE_.

dwNumRingsNoAnswer

Количество колец, заданных для этого адреса до того, как звонок без ответа считается отсутствием ответа.

dwForwardNumEntries

Количество записей в массиве, на которые ссылаются dwForwardSize и dwForwardOffset.

dwForwardSize

Размер массива пересылаемых данных в байтах.

dwForwardOffset

Смещение от начала структуры к полю изменяющегося размера, которое описывает сведения о пересылке адреса. Эти сведения являются массивом элементов dwForwardNumEntries типа LINEFORWARD. Смещения адресов в массиве относятся к началу структуры LINEADDRESSSTATUS . Смещения dwCallerAddressOffset и dwDestAddressOffset в поле изменчивого размера типа LINEFORWARD , на которое указывает dwForwardOffset , относятся к началу структуры данных LINEADDRESSSTATUS (корневой контейнер). Размер массива определяется параметром dwForwardSize.

dwTerminalModesSize

Размер массива режимов терминала в байтах.

dwTerminalModesOffset

Смещение от начала структуры до поля устройства изменчивого размера, содержащего массив с записями размера DWORD, которые используют одну или несколько констант LINETERMMODE_. Этот массив индексируется по идентификаторам терминала в диапазоне от нуля до одного меньше, чем dwNumTerminals. Каждая запись в массиве указывает текущие режимы терминала для соответствующего набора терминалов с функцией lineSetTerminal для этого адреса. Размер массива определяется параметром dwTerminalModesSize.

dwDevSpecificSize

Размер поля для конкретного устройства в байтах.

dwDevSpecificOffset

Смещение от начала этой структуры к полю устройства изменяющегося размера. Размер поля определяется dwDevSpecificSize.

Эта структура данных возвращается функцией lineGetAddressStatus . Когда элементы в этой структуре данных изменяются в результате действий с адресом, в приложение отправляется LINE_ADDRESSSTATE сообщение. Параметр этого сообщения — это состояние адреса, одна из констант LINEADDRESSSTATE_, которая указывает, что элемент состояния в этой записи изменился.