使用英语阅读

通过

lineGetAddressIDA 函数 （tapi.h）

  • 项目

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

语法

LONG lineGetAddressIDA(
  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 范围中的零到行设备功能中返回的地址数减去 1。 lineMakeCall 函数允许应用程序通过指定行句柄和行上的地址进行调用。 地址可以指定为 dwAddressID、电话号码或特定于设备的名称或标识符。 在为单行分配多个地址的环境中，使用电话号码可能很实用。

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

备注

tapi.h 标头将 lineGetAddressID 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
目标平台 窗户
标头 tapi.h
库 Tapi32.lib
DLL Tapi32.dll

另请参阅

基本电话服务参考

TAPI 2.2 参考概述

lineMakeCall