lineGetAddressID 函数 (tapi.h)

项目
03/05/2024

lineGetAddressID 函数返回与指定行上采用不同格式的地址关联的地址标识符。

语法

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

参数

hLine

开行设备的句柄。

lpdwAddressID

指向返回地址标识符的 DWORD 大小的内存位置的指针。地址标识符与地址永久关联;标识符在操作系统升级中保持不变。

dwAddressMode

lpsAddress 中包含的地址的地址模式。此参数使用一个且只使用一个 LINEADDRESSMODE_常量。必须指定LINEADDRESSMODE_DIALABLEADDR。

lpsAddress

指向包含分配给指定线路设备的地址的数据结构的指针。地址的格式由 dwAddressMode 确定。由于唯一有效的值为 LINEADDRESSMODE_DIALABLEADDR， 因此 lpsAddress 使用常见的可拨号号码格式，并且以 null 结尾。

dwSize

lpsAddress 中包含的地址的大小（以字节为单位）。字符串的大小必须包含 null 终止符。

返回值

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALADDRESS、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

注解

lineGetAddressID 函数用于将分配给线路设备的电话号码 (地址) 映射回其 dwAddressID，范围为 0 到地址数减去线路设备功能中返回的地址数。 lineMakeCall 函数允许应用程序通过在行上指定行句柄和地址进行调用。地址可以指定为 dwAddressID、电话号码或设备特定的名称或标识符。在为单行分配多个地址的环境中，使用电话号码可能很实用。

注意 LINEADDRESSMODE_ADDRESSID不能与 lineGetAddressID 一起使用。