lineGetAddressStatus 函数 (tapi.h)
lineGetAddressStatus 函数允许应用程序查询指定地址的当前状态。
语法
LONG lineGetAddressStatus(
HLINE hLine,
DWORD dwAddressID,
LPLINEADDRESSSTATUS lpAddressStatus
);
参数
hLine
开行设备的句柄。
dwAddressID
给定开行设备上的地址。 这是要查询的地址。 地址标识符与地址永久关联;标识符在操作系统升级中保持不变。
lpAddressStatus
指向 LINEADDRESSSTATUS 类型的可变大小数据结构的指针。 在调用 lineGetAddressStatus 之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。
注意 如果结构中的大小参数不正确，则有可能覆盖数据。 有关设置结构大小的详细信息，请参阅 内存分配 主题。
返回值
如果请求成功，则返回零;如果发生错误，则返回负错误号。 可能的返回值为：
LINEERR_INVALADDRESSID、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_OPERATIONUNAVAIL、LINEERR_OPERATIONFAILED。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tapi.h |
| Library | Tapi32.lib |
| DLL | Tapi32.dll |