lineRegisterRequestRecipient 函数 (tapi.h)

项目
03/13/2024

lineRegisterRequestRecipient 函数将调用应用程序注册为指定请求模式的请求接收方。

语法

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

参数

hLineApp

TAPI 行部分的应用程序使用句柄。

dwRegistrationInstance

作为LINE_REQUEST消息的参数传递回的应用程序特定 DWORD。此消息通知应用程序请求处于挂起状态。如果 bEnable 设置为零，则忽略此参数。 TAPI 仅检查此参数进行注册，而不是取消注册。注销时使用的 dwRegistrationInstance 值不需要与注册请求模式时使用的 dwRegistrationInstance 值匹配。

dwRequestMode

应用程序为其注册的请求类型。此参数使用一个或多个 LINEREQUESTMODE_常量。

bEnable

如果 为 TRUE，则应用程序注册指定的请求模式;如果 为 FALSE，则应用程序将针对指定的请求模式取消注册。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

LINEERR_INVALAPPHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALREQUESTMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注解

支持电话功能的应用程序可以通过调用 tapiRequestMakeCall 来请求代表其进行呼叫。此外，其他应用程序可以请求使用给定调用记录信息。 tapiRequestMakeCall 请求由 TAPI 排队，已注册处理请求的最高优先级应用程序将发送LINE_REQUEST消息，其中指示挂起的请求模式。此应用程序通常是用户的呼叫控制应用程序。

接下来，接收此消息的调用控制应用程序调用 lineGetRequest，指定请求模式和足以容纳请求的缓冲区。然后，调用控制应用程序解释并执行请求。

当接收方应用程序执行 lineShutdown 时，也会为所有请求自动取消注册。