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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | tapi.h |
| Library | Tapi32.lib |
| [DLL] | Tapi32.dll |