ITAgent::CreateSession メソッド (tapi3.h)

CreateSession メソッドは、入力 ACD グループとアドレスの新しいエージェント セッションを作成します。

構文

HRESULT CreateSession(
  [in]  ITACDGroup     *pACDGroup,
  [in]  ITAddress      *pAddress,
  [out] ITAgentSession **ppAgentSession
);

パラメーター

[in] pACDGroup

ITACDGroup インターフェイスへのポインター。

[in] pAddress

ACD 呼び出しを受信するために使用できる ITAddress オブジェクトへのポインター。

[out] ppAgentSession

作成されたオブジェクトの ITAgentSession インターフェイスへのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

説明
S_OK
メソッドが成功しました。
E_POINTER
ppAgentSession パラメーターが有効なポインターではありません。
E_UNEXPECTED
ターゲット アドレスの行を開けませんでした。
E_INVALIDARG
pACDGroup 引数または pAddress 引数が無効です。
E_OUTOFMEMORY
操作を実行するためのメモリが不足しています。
TAPI_E_TIMEOUT
TAPI 3 DLL によってタイムアウトしたため、操作に失敗しました。タイムアウト間隔は 2 分です。

解説

TAPI は、ITAgent::CreateSession によって返される ITAgentSession インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、関連付けられているリソースを解放するために、ITAgentSession インターフェイスで Release を呼び出す必要があります。

一部の電話環境では、セッションを開くために個人識別番号が必要です。 「CreateSessionWithPIN」を参照してください。

要件

   
対象プラットフォーム Windows
ヘッダー tapi3.h (Tapi3.h を含む)
Library Uuid.lib
[DLL] Tapi3.dll

関連項目

IEnumAgentSession

ITACDGroup

ITAddress

ITAgent

ITAgent::CreateSessionWithPIN

ITAgentSession