ITAgentHandler::CreateAgentWithID メソッド (tapi3cc.h)

  • [アーティクル]

CreateAgentWithID メソッドは、エージェント識別子に基づいて Agent オブジェクトを作成します。 この識別子は、レガシ ACD システム上のエージェントを識別する文字列です。 システムでグループへのログインに PIN またはパスワードも必要な場合は、このメソッドを使用して PIN またはパスワードを設定します。

構文

HRESULT CreateAgentWithID(
  [in]  BSTR    pID,
  [in]  BSTR    pPIN,
  [out] ITAgent **ppAgent
);

パラメーター

[in] pID

エージェント識別子を含む BSTR へのポインター。

[in] pPIN

エージェント PIN を含む BSTR へのポインター。

[out] ppAgent

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

戻り値

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

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

解説

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

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

要件

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

関連項目

CreateAgent

ITAgent

ITAgentHandler