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 |