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、onhold、 onholdpendingtransfer 和 onholdpendingconference 以外的调用状态的调用数。

dwNumOnHoldCalls

处于保留状态的地址上的调用数。

dwNumOnHoldPendCalls

处于 onholdpendingtransfer 或 onholdpendingconference 状态的地址上的调用数。

dwAddressFeatures

可对其当前状态的地址调用的与地址相关的函数。此成员使用一个或多个 LINEADDRFEATURE_常量。

dwNumRingsNoAnswer

在未应答的呼叫被视为无应答之前为此地址设置的响铃数。

dwForwardNumEntries

由 dwForwardSize 和 dwForwardOffset 引用的数组中的条目数。

dwForwardSize

转发信息数组的大小（以字节为单位）。

dwForwardOffset

从结构开头到描述地址转发信息的可变大小的字段的偏移量。此信息是 dwForwardNumEntries 元素的数组，类型为 LINEFORWARD。数组中地址的偏移量相对于 LINEADDRESSSTATUS 结构的开头。 dwForwardOffset 指向的 LINEFORWARD 类型的可变大小字段中的 dwCallerAddressOffset 和 dwDestAddressOffset 偏移量相对于 LINEADDRESSSTATUS 数据结构的开头 (“root”容器) 。数组的大小由 dwForwardSize 指定。

dwTerminalModesSize

终端模式数组的大小（以字节为单位）。

dwTerminalModesOffset

从结构的开头到大小可变的设备字段的偏移量，该字段包含具有 DWORD 大小的条目的数组，这些条目使用一个或多个 LINETERMMODE_常量。此数组按终端标识符编制索引，范围为 0 到小于 dwNumTerminals 的 1。数组中的每个条目指定具有此地址的 lineSetTerminal 函数的相应终端集的当前终端模式。数组的大小由 dwTerminalModesSize 指定。

dwDevSpecificSize

设备特定字段的大小（以字节为单位）。

dwDevSpecificOffset

从此结构的开头到大小可变的设备特定字段的偏移量。字段的大小由 dwDevSpecificSize 指定。