lineSetStatusMessages 函数 (tapi.h)

  • 项目

lineSetStatusMessages 函数使应用程序能够指定要接收与指定行或其任何地址的状态更改相关的事件的通知消息。

语法

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

参数

hLine

线路设备的句柄。

dwLineStates

标识要向应用程序发送消息的行设备状态更改的位数组。 此参数使用一个或多个 LINEDEVSTATE_常量。

dwAddressStates

标识要向其发送消息的地址状态更改的位数组。 此参数使用一个或多个 LINEADDRESSSTATE_常量。

返回值

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

LINEERR_INVALADDRESSSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINESTATE、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_OPERATIONUNAVAIL。

注解

TAPI 定义了一些消息，用于通知应用程序有关在行和地址上发生的事件。 应用程序可能对接收所有地址和行状态更改消息不感兴趣。 lineSetStatusMessages 函数可用于选择应用程序接收的消息。 默认情况下，地址和行状态报告处于禁用状态。

要求

要求 值
目标平台 Windows
标头 tapi.h
Library Tapi32.lib
DLL Tapi32.dll

另请参阅

基本电话服务参考

LINE_CLOSE

LINE_LINEDEVSTATE

TAPI 2.2 参考概述

lineInitialize

lineInitializeEx

lineOpen