lineGetAddressCaps 函数 (tapi.h)

项目
03/05/2024

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

语法

LONG lineGetAddressCaps(
  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。