通过

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
 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