lineAgentSpecific 関数 (tapi.h)

[アーティクル]
03/08/2023

lineAgentSpecific 関数を使用すると、アプリケーションはアドレスに関連付けられているエージェントハンドラーの独自のハンドラー固有の関数にアクセスできます。拡張機能の意味は、エージェントハンドラーに固有のものです。エージェント関連の拡張機能の各セットは、その拡張機能のプロマルゲーター (通常はテレフォニーサーバー上のエージェントハンドラーソフトウェアの作成者) から、拡張機能の仕様と共に取得する必要がある、ユニバーサルに一意の 128 ビット拡張機能 ID によって識別されます。エージェントハンドラーでサポートされる拡張機能の一覧は、lineGetAgentCaps によって返される LINEAGENTCAPS 構造体から取得されます。

構文

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

パラメーター

hLine

開線デバイスへのハンドル。

dwAddressID

オープンラインデバイスのアドレス。アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティングシステムのアップグレード間で一定のままです。

dwAgentExtensionIDIndex

呼び出されるエージェントハンドラー拡張機能の LINEAGENTCAPS 内の ExtensionIDList 構造体内の位置。

lpParams

パラメーターブロックを保持するために使用されるメモリ領域へのポインター。このパラメーターブロックの形式はデバイス固有であり、その内容はテレフォニーサーバー上のエージェントハンドラーアプリケーションとの間で TAPI によって渡されます。このパラメーターブロックでは、呼び出される関数を指定し、データを返すのに十分なスペースを含める必要があります。

dwSize

パラメーターブロック領域のサイズ (バイト単位)。

メモlpParams が文字列へのポインターである場合、サイズには NULL 終端記号を含める必要があります。

戻り値

非同期操作が開始された場合は、正の要求識別子を返します。それ以外の場合、この関数は次のいずれかの負のエラー値を返します。

LINEERR_INVALADDRESSID、LINEERR_INVALAGENTID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL、LINEERR_UNINITIALIZED。

追加の戻り値は、エージェントハンドラーに固有です。

注釈

この操作は、拡張テレフォニーサービスの一部です。その意味を定義せずに、エージェントハンドラー固有の機能へのアクセスを提供します。

この関数は、ジェネリックパラメータープロファイルを提供します。パラメーター構造体の解釈はハンドラー固有です。ハンドラー固有のアプリケーションに送り返される指示と応答では、 LINE_AGENTSPECIFIC メッセージを使用する必要があります。

エージェントハンドラーは、この関数で使用するパラメーターを定義することで、ハンドラー固有の関数へのアクセスを提供できます。これらの拡張機能を使用するアプリケーションでは、定義されている拡張機能について説明しているベンダー固有のドキュメントを参照する必要があります。通常、これらの拡張機能に依存するアプリケーションは、他のエージェントハンドラー環境では動作しません。