itAgentHandler：：CreateAgentWithID 方法 (tapi3.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

此方法可以返回其中一个值。

值	含义
S_OK	方法成功。
E_INVALIDARG	pPIN 参数为 NULL。
E_POINTER	ppAgent 参数不是有效的指针。
E_OUTOFMEMORY	内存不足，无法执行操作。
TAPI_E_TIMEOUT	操作失败，因为 TAPI 3 DLL 使其超时。超时间隔为两分钟。

应用程序必须使用 SysAllocString 为 pID 和 pPIN 参数分配内存，并在不再需要变量时使用 SysFreeString 释放内存。

TAPI 在 ITAgentHandler：：CreateAgentWithID 返回的 ITAgent 接口上调用 AddRef 方法。应用程序必须在 ITAgent 接口上调用 Release，以释放与其关联的资源。