lineCreateAgentSessionA 函数 (tapi.h)

lineCreateAgentSession 函数创建新的 AgentSession 对象。 它生成要发送到已注册代理函数处理程序的 LINE_PROXYREQUEST 消息,引用 LINEPROXYREQUEST 类型LINEPROXYREQUEST_CREATEAGENTSESSION结构。

语法

LONG lineCreateAgentSessionA(
  HLINE           hLine,
  HAGENT          hAgent,
  LPCSTR          lpszAgentPIN,
  DWORD           dwWorkingAddressID,
  LPGUID          lpGroupID,
  LPHAGENTSESSION lphAgentSession
);

参数

hLine

线路设备的句柄。

hAgent

要为其创建会话的代理的标识符。

lpszAgentPIN

指向包含代理 PIN 或密码的 null终止的 Unicode 字符串的指针。 在处理需要为每个创建的会话使用单独的 PIN 的旧 ACD 系统(或已登录组)时使用。 使用操作系统的用户登录名进行身份验证的 ACD 系统,lpszAgentPIN 设置为 NULL

dwWorkingAddressID

代理将接收此会话调用的地址的标识符。

lpGroupID

指向标识要为其创建会话的组的 GUID 的指针。

lphAgentSession

ACD 代理返回的已创建的代理会话的句柄。 代理处理程序代理应用程序负责生成和维护这些标识符的唯一性。

返回值

如果异步操作启动,则返回请求标识符;否则,该函数将返回以下错误值之一:

LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。

言论

注意

tapi.h 标头将 lineCreateAgentSession 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
目标平台 窗户
标头 tapi.h
Tapi32.lib
DLL Tapi32.dll

另请参阅

关于呼叫中心控件 的

LINEPROXYREQUEST

LINE_PROXYREQUEST