TSPI_lineGetAddressID 函数 (tspi.h)
TSPI_lineGetAddressID 函数返回与指定行上采用不同格式的地址关联的地址标识符。
语法
LONG TSPIAPI TSPI_lineGetAddressID(
HDRVLINE hdLine,
LPDWORD lpdwAddressID,
DWORD dwAddressMode,
LPCWSTR lpsAddress,
DWORD dwSize
);
参数
hdLine
要检索其地址的行的服务提供商句柄。
lpdwAddressID
指向返回地址标识符的 DWORD 大小的内存位置的指针。
dwAddressMode
lpsAddress 中包含的地址的地址模式。 允许 dwAddressMode 参数具有一个且只有一个 LINEADDRESSMODE_常量。
lpsAddress
指向包含分配给指定线路设备的地址的数据结构的指针。 地址的格式由 dwAddressMode 参数确定。 如果LINEADDRESSMODE_DIALABLEADDR， 则 lpsAddress 参数使用常见的可拨号号码格式，并且以 NULL 结尾。
dwSize
lpsAddress 中包含的地址的大小。 如果使用LINEADDRESSMODE_DIALABLEADDR，必须将参数 dwSize 设置为字符串的长度 (加上 NULL) 的长度。 如果使用扩展 LINEADDRESSMODE，则长度应与 DLL 检查 (实际传递的任何内容的大小匹配，以确保它可以读取给定指针) 指定的字节数。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESS、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。
注解
此函数用于将分配给线路设备的电话号码 (地址) 映射回其 dwAddressID (，范围从 0 到地址数减去线路设备功能中返回的一) 。
要求
| 目标平台 | Windows |
| 标头 | tspi.h |