lineGetStatusMessages 函数 (tapi.h)

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

语法

LONG lineGetStatusMessages(
  HLINE   hLine,
  LPDWORD lpdwLineStates,
  LPDWORD lpdwAddressStates
);

hLine

线路设备的句柄。

lpdwLineStates

标识要向应用程序发送消息的行设备状态更改的位数组。如果标志为 TRUE，则启用该消息;如果 为 FALSE，则禁用它。此参数使用一个或多个 LINEDEVSTATE_常量。

lpdwAddressStates

用于标识要向应用程序发送消息的地址状态更改的位数组。如果标志为 TRUE，则启用该消息;如果 为 FALSE，则禁用。此参数使用一个或多个 LINEADDRESSSTATE_常量。

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

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