lineGetDevCapsW 函数（tapi.h）

2024-11-20

lineGetDevCaps 函数查询指定的线路设备以确定其电话功能。返回的信息对于行设备上的所有地址都有效。

语法

LONG lineGetDevCapsW(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

参数

hLineApp

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

dwDeviceID

要查询的行设备的标识符。

dwAPIVersion

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

dwExtVersion

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

lpLineDevCaps

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

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

返回值

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

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

言论

在使用 lineGetDevCaps之前，应用程序必须协商要使用的 API 版本号，如果需要，必须使用扩展版本。

API 和扩展版本号是 TAPI 和服务提供商必须在其下操作的版本号。如果版本范围不重叠，则应用程序、API 或服务提供程序版本不兼容，并返回错误。

此函数返回的 LINEDEVCAPS 结构中的其中一个成员包含分配给指定行设备的地址数。用于引用各个地址的实际地址标识符从零到一个小于返回的数字。每个地址的功能可能有所不同。对每个可用的 <dwDeviceID使用 lineGetAddressCaps，dwAddressID> 组合来确定每个地址的确切功能。请注意，地址标识符永久关联到地址;标识符在操作系统升级中保持不变。

注意

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