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

  • [アーティクル]

CreateSessionWithPIN メソッドは、個人識別番号 (PIN) を使用して、入力 ACD グループとアドレスの新しいエージェント セッションを作成します。

構文

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

パラメーター

[in] pACDGroup

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

[in] pAddress

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

[in] pPIN

エージェントの PIN の BSTR 表現へのポインター。

[out] ppAgentSession

作成されたセッションへのポインター。

戻り値

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

値 説明
S_OK
 メソッドが成功しました。
TAPI_E_CALLCENTER_NO_AGENT_ID
 CreateAgentWithID によってエージェントが作成されません。
TAPI_E_TIMEOUT
 TAPI 3 DLL によってタイムアウトしたため、操作が失敗しました。タイムアウト間隔は 2 分です。
E_INVALIDARG
 pPIN は NULL です。
E_POINTER
 pPIN パラメーターまたは ppAgentSession パラメーターが有効なポインターではありません。
E_OUTOFMEMORY
 操作を実行するためのメモリが不足しています。

解説

アプリケーションでは 、SysAllocString を使用して pPIN のメモリを割り当て、変数が不要になったときに SysFreeString を使用してメモリを解放する必要があります。

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

要件

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

関連項目

ITAgent

ITAgent::CreateSession

ITAgentSession