lineRegisterRequestRecipient 函数 (tapi.h)
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 时,也会为所有请求自动取消注册。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tapi.h |
Library | Tapi32.lib |
DLL | Tapi32.dll |