次の方法で共有

lineGetAgentActivityListA 関数 (tapi.h)

  • [アーティクル]

lineGetAgentActivityList 関数は、lineSetAgentActivity を使用してアプリケーションが選択できるアクティビティの ID を取得し、エージェントが現時点で実際に実行している関数を示します。

構文

LONG lineGetAgentActivityListA(
  HLINE                   hLine,
  DWORD                   dwAddressID,
  LPLINEAGENTACTIVITYLIST lpAgentActivityList
);

パラメーター

hLine

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

dwAddressID

エージェントの状態を照会するオープンライン デバイスのアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード全体で一定のままです。

lpAgentActivityList

LINEAGENTACTIVITYLIST 型の可変サイズの構造体へのポインター。 要求が正常に完了すると、この構造体には 、lineSetAgentActivity を使用して選択できるエージェント アクティビティ コードの一覧が入力されます。 lineGetAgentActivityList を呼び出す前に、アプリケーションは、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。

戻り値

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

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

解説

注意

tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGetAgentActivityList を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

必要条件

   
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

関連項目

LINEAGENTACTIVITYLIST

補助回線サービス関数

TAPI 2.2 リファレンスの概要

lineSetAgentActivity