lineGetAddressCapsA 函数（tapi.h）

2024-11-20

lineGetAddressCaps 函数查询指定线路设备上的指定地址以确定其电话功能。

语法

LONG lineGetAddressCapsA(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

参数

hLineApp

使用 TAPI 处理应用程序的注册。

dwDeviceID

包含要查询的地址的行设备。

dwAddressID

要查询其功能的给定行设备上的地址。地址标识符永久关联到地址;标识符在操作系统升级中保持不变。

dwAPIVersion

要使用的电话 API 的版本号。高序单词包含主版本号;低序字包含次要版本号。此数字由 lineNegotiateAPIVersion获取。

dwExtVersion

要使用的特定于服务提供商的扩展的版本号。如果未使用任何特定于设备的扩展，则可以将此数字设置为零。否则，高序单词包含主要版本号;和低序单词包含次要版本号。

lpAddressCaps

指向 LINEADDRESSCAPS类型的可变大小的结构的指针。成功完成请求后，此结构将填充地址功能信息。在调用 lineGetAddressCaps之前，应用程序应设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

注意如果结构中的大小参数不正确，则有可能覆盖数据。有关设置结构大小的详细信息，请参阅内存分配主题。

返回值

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

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONFAILED、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALAPPHANDLE、LINEERR_UNINITIALIZED、LINEERR_INVALPOINTER、LINEERR_OPERATIONUNAVAIL、LINEERR_NODRIVER、LINEERR_NODEVICE。