LINEAGENTCAPS 構造体 (tapi.h)

[アーティクル]
03/05/2024

LINEAGENTCAPS 構造体は、ACD エージェントの機能を記述します。 lineGetAgentCaps 関数は、LINEAGENTCAPS 構造体を返します。

構文

typedef struct lineagentcaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwAgentHandlerInfoSize;
  DWORD dwAgentHandlerInfoOffset;
  DWORD dwCapsVersion;
  DWORD dwFeatures;
  DWORD dwStates;
  DWORD dwNextStates;
  DWORD dwMaxNumGroupEntries;
  DWORD dwAgentStatusMessages;
  DWORD dwNumAgentExtensionIDs;
  DWORD dwAgentExtensionIDListSize;
  DWORD dwAgentExtensionIDListOffset;
  GUID  ProxyGUID;
} LINEAGENTCAPS, *LPLINEAGENTCAPS;

メンバー

dwTotalSize

このデータ構造に割り当てられた合計サイズ (バイト単位)。

dwNeededSize

要求されたすべての情報をバイト単位で保持するために必要なサイズ。

dwUsedSize

有用な情報を含むこのデータ構造の部分のサイズ (バイト単位)。

dwAgentHandlerInfoSize

エージェントハンドラー情報のサイズ (バイト単位)。

dwAgentHandlerInfoOffset

構造体の先頭から、エージェント要求を処理しているサーバーアプリケーションの名前、バージョン、またはその他の識別情報を指定する null で終わる文字列へのオフセット。文字列のサイズは dwAgentHandlerInfoSize によって指定されます。

dwCapsVersion

この構造体の内容の準備にエージェントハンドラーアプリケーションが使用した TAPI バージョン。これは、呼び出し元のアプリケーションが lineGetAgentCaps に渡した API バージョンを超える値です。

dwFeatures

LINEAGENTFEATURE_定数を使用して、この行で使用できるエージェント関連の機能。サポートされている機能を呼び出すには、回線とアドレスが適切な状態である必要があります。ビット位置の 0 は、対応する機能が使用できないことを示します。 1 つは、ラインが操作が意味を持つ適切な状態にある場合に、対応するフィーチャが使用可能であることを示します。このフィールドを使用すると、アプリケーションは、デバイスでサポートできるエージェント機能 (およびサポートできないエージェント機能) を検出できます。

dwStates

lineSetAgentState の dwAgentState パラメーターで使用できる定数をLINEAGENTSTATE_します。サポートされている状態を設定するには、行とアドレスが適切な状態である必要があります。ビット位置の 0 は、対応する状態が使用できないことを示します。 1 つは、行が状態が意味のある適切な状態にある場合に、対応する状態が使用可能であることを示します。このフィールドを使用すると、アプリケーションは、デバイスでサポートできるエージェントの状態 (およびサポートできない状態) を検出できます。

dwNextStates

lineSetAgentState の dwNextAgentState パラメーターで使用できる定数をLINEAGENTSTATE_します。サポートされている状態を設定するには、行とアドレスが適切な状態である必要があります。ビット位置の 0 は、対応する状態が使用できないことを示します。 1 つは、行が状態が意味のある適切な状態にある場合に、対応する状態が使用可能であることを示します。このフィールドを使用すると、アプリケーションは、デバイスでサポートできるエージェントの状態 (およびサポートできない状態) を検出できます。

dwMaxNumGroupEntries

アドレスに同時にログインできるエージェント識別子の最大数。 LINEAGENTGROUPLIST 構造体の dwNumEntries メンバーとして lineSetAgentGroup に渡すことができる最大値を決定します。

dwAgentStatusMessages

LINE_AGENTSTATUS メッセージの dwParam2 でアプリケーションが受け取ることができるLINEAGENTSTATUS_定数を示します。

dwNumAgentExtensionIDs

ExtensionIDList 配列に表示される LINEEXTENSIONID 構造体の数。エージェントハンドラー固有の拡張機能がアドレスでサポートされている場合、値は 0 です。

dwAgentExtensionIDListSize

エージェント拡張機能 ID 配列のサイズ (バイト単位)。

dwAgentExtensionIDListOffset

構造体の先頭から LINEEXTENSIONID 構造体の配列へのオフセット。サイズは dwNumExtensionIDs 倍 SIZEOF(LINEEXTENSIONID) です。配列には、アドレスのエージェントハンドルでサポートされているすべてのエージェントハンドラー固有の拡張機能の 128 ビットユニバーサル一意識別子が一覧表示されます。使用されている拡張機能は lineAgentSpecific 関数で参照され、このテーブル内の最初のエントリであるエントリ 0 の位置によってメッセージが LINE_AGENTSPECIFIC されるため、エージェントハンドラーは常に同じ順序でこの配列に拡張識別子を提示することが重要です。配列のサイズは dwAgentExtensionIDListOffset によって指定されます。

ProxyGUID

行に関連付けられている ACD プロキシの GUID。この要素は、TAPI バージョン 2.2 以降をネゴシエートするアプリケーションにのみ公開されます。