lineCreateAgentA 函数 (tapi.h)

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

语法

LONG lineCreateAgentA(
  HLINE    hLine,
  LPCSTR   lpszAgentID,
  LPCSTR   lpszAgentPIN,
  LPHAGENT lphAgent
);

参数

hLine

线路设备的句柄。

lpszAgentID

指向包含代理标识符的 null-terminated Unicode 字符串的指针。 使用旧版 ACD 系统时使用。 使用操作系统的用户登录名进行身份验证的 ACD 系统,lpszAgentID 设置为 NULL

lpszAgentPIN

指向包含代理 PIN 或密码的 null终止的 Unicode 字符串的指针。 使用旧版 ACD 系统时使用。 使用操作系统的用户登录名进行身份验证的 ACD 系统,lpszAgentPIN 设置为 NULL

lphAgent

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

返回值

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

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

言论

注意

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

要求

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

另请参阅

LINEPROXYREQUEST

LINE_PROXYREQUEST