通过

lineGetLineDevStatus 函数 (tapi.h)

  • 项目

lineGetLineDevStatus 函数使应用程序能够查询指定的开行设备以获取其当前状态。

语法

LONG lineGetLineDevStatus(
  HLINE           hLine,
  LPLINEDEVSTATUS lpLineDevStatus
);

参数

hLine

要查询的开行设备的句柄。

lpLineDevStatus

指向 LINEDEVSTATUS 类型的可变大小数据结构的指针。 成功完成请求后，此结构将填充行的设备状态。 在调用 lineGetLineDevStatus 之前，应用程序应设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

返回值

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

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

注解

应用程序使用 lineGetLineDevStatus 查询线路设备的当前行状态。 此状态信息全局应用于线路设备上的所有地址。 使用 lineGetAddressStatus 确定有关行上特定地址的状态信息。

要求

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

另请参阅

基本电话服务参考

LINEDEVSTATUS

TAPI 2.2 参考概述

lineGetAddressStatus