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 接口的指针。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法成功。 |
|
ppAgentSession 参数不是有效的指针。 |
|
无法打开目标地址的行。 |
|
pACDGroup 或 pAddress 参数无效。 |
|
内存不足,无法执行操作。 |
|
操作失败,因为 TAPI 3 DLL 使其超时。超时间隔为两分钟。 |
注解
TAPI 在 ITAgent::CreateSession 返回的 ITAgentSession 接口上调用 AddRef 方法。 应用程序必须在 ITAgentSession 接口上调用 Release,以释放与其关联的资源。
某些电话环境需要个人标识号才能打开会话。 请参阅 CreateSessionWithPIN。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tapi3.h (包括 Tapi3.h) |
Library | Uuid.lib |
DLL | Tapi3.dll |