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

アイドル状態、保留状態、保留保留転送、および onholdpendingconference 以外の呼び出し状態にあるアドレスの呼び出しの数。

dwNumOnHoldCalls

保留状態のアドレスに対する呼び出しの数。

dwNumOnHoldPendCalls

onholdpendingtransfer または onholdpendingconference 状態のアドレスに対する呼び出しの数。

dwAddressFeatures

現在の状態のアドレスで呼び出すことができるアドレス関連の関数。このメンバーは、1 つ以上の LINEADDRFEATURE_定数を使用します。

dwNumRingsNoAnswer

未応答の呼び出しの前にこのアドレスに設定されたリングの数は、応答なしと見なされます。

dwForwardNumEntries

dwForwardSize および dwForwardOffset によって参照される配列内のエントリの数。

dwForwardSize

転送情報配列のサイズ (バイト単位)。

dwForwardOffset

構造体の先頭から、アドレスの転送情報を記述する可変サイズのフィールドへのオフセット。この情報は、LINEFORWARD 型の dwForwardNumEntries 要素の配列です。配列内のアドレスのオフセットは、 LINEADDRESSSTATUS 構造体の先頭を基準にしています。 dwForwardOffset が指す LINEFORWARD 型の可変サイズフィールドの dwCallerAddressOffset と dwDestAddressOffsetのオフセットは、LINEADDRESSSTATUS データ構造 ("ルート" コンテナー) の先頭を基準とします。配列のサイズは dwForwardSize で指定します。

dwTerminalModesSize

ターミナルモード配列のサイズ (バイト単位)。

dwTerminalModesOffset

構造体の先頭から、1 つ以上のLINETERMMODE_定数を使用する DWORD サイズのエントリを含む配列を含む可変サイズのデバイスフィールドへのオフセット。この配列は、0 から dwNumTerminals より 1 未満の範囲のターミナル識別子によってインデックスが作成されます。配列内の各エントリは、このアドレスの lineSetTerminal 関数を使用して、対応するターミナルセットの現在のターミナルモードを指定します。配列のサイズは dwTerminalModesSize によって指定されます。

dwDevSpecificSize

デバイス固有のフィールドのサイズ (バイト単位)。

dwDevSpecificOffset

この構造体の先頭から可変サイズのデバイス固有フィールドへのオフセット。フィールドのサイズは dwDevSpecificSize によって指定されます。

注釈

デバイス固有の拡張機能では、このデータ構造の DevSpecific (dwDevSpecificSize と dwDevSpecificOffset) の可変サイズ領域を使用する必要があります。

このデータ構造は、 lineGetAddressStatus 関数によって返されます。アドレスのアクティビティの結果としてこのデータ構造内の項目が変更されると、 LINE_ADDRESSSTATE メッセージがアプリケーションに送信されます。このメッセージのパラメーターはアドレスの状態であり、このレコードの状態項目が変更されたことを示す LINEADDRESSSTATE_定数の 1 つです。