次の方法で共有

lineGetAgentCapsA 関数 (tapi.h)

  • [アーティクル]

lineGetAgentCaps 関数は、指定された回線デバイスでサポートされているエージェント関連の機能を取得します。 特定のエージェントに名前が付けられている場合、この機能には、エージェントのログインが許可されている ACD グループの一覧が含まれます。

構文

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

パラメーター

hLineApp

TAPI を使用してアプリケーションの登録を処理します。

dwDeviceID

クエリ対象のアドレスを含む回線デバイス。

dwAddressID

クエリを実行する機能を持つ特定の回線デバイス上のアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード間で一定のままです。

dwAppAPIVersion

アプリケーションでサポートされている最も高い API バージョン。 これは、クエリ対象のデバイス lineNegotiateAPIVersion を使用してネゴシエートされる値にすることはできません。

lpAgentCaps

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

戻り値

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

LINEERR_BADDEVICEID、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_INVALADDRESSID、LINEERR_INVALAPPHANDLE、LINEERR_INVALPOINTER、LINEERR_NODEVICE、LINEERR_NODRIVER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL、LINEERR_UNINITIALIZED。

備考

手記

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

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー tapi.h
ライブラリ Tapi32.lib
DLL Tapi32.dll

関連項目

LINEAGENTCAPS

補助回線サービス関数

TAPI 2.2 リファレンスの概要

lineNegotiateAPIVersion