itAgent::CreateSession 方法 (tapi3.h)

CreateSession 方法为输入 ACD 组和地址创建新的代理会话。

语法

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

参数

[in] pACDGroup

指向 ITACDGroup 接口的 指针。

[in] pAddress

指向可用于接收 ACD 调用的 ITAddress 对象的指针。

[out] ppAgentSession

指向所创建对象的 ITAgentSession 接口的指针。

返回值

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

含义
S_OK
方法成功。
E_POINTER
ppAgentSession 参数不是有效的指针。
E_UNEXPECTED
无法打开目标地址的行。
E_INVALIDARG
pACDGrouppAddress 参数无效。
E_OUTOFMEMORY
内存不足,无法执行操作。
TAPI_E_TIMEOUT
操作失败,因为 TAPI 3 DLL 使其超时。超时间隔为两分钟。

注解

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

某些电话环境需要个人标识号才能打开会话。 请参阅 CreateSessionWithPIN

要求

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

另请参阅

IEnumAgentSession

ITACDGroup

ITAddress

ITAgent

ITAgent::CreateSessionWithPIN

ITAgentSession