ITAgent::CreateSessionWithPIN 方法 (tapi3.h)

CreateSessionWithPIN 方法为输入 ACD 组和地址创建新的代理会话,其中个人标识号 (PIN) 。

语法

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 将其超时。超时间隔为两分钟。
E_INVALIDARG
pPINNULL
E_POINTER
pPINppAgentSession 参数不是有效的指针。
E_OUTOFMEMORY
内存不足,无法执行操作。

注解

应用程序必须使用 SysAllocStringpPIN 分配内存,并在不再需要变量时使用 SysFreeString 释放内存。

TAPI 在 ITAgent::CreateSessionWithPIN 返回的 ITAgentSession 接口上调用 AddRef 方法。 应用程序必须在 ITAgentSession 接口上调用 Release,以释放与之关联的资源。

要求

   
目标平台 Windows
标头 tapi3.h (包括 Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

另请参阅

ITAgent

ITAgent::CreateSession

ITAgentSession