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

[アーティクル]
03/05/2024

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」を参照してください。