lineGetTranslateCapsA 函数 (tapi.h)

lineGetTranslateCaps 函数返回地址转换功能。

语法

LONG lineGetTranslateCapsA(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

参数

hLineApp

lineInitializeEx 函数返回的句柄。 如果应用程序尚未调用 lineInitializeEx 函数,此参数可以为零。

Note TAPI 1.4 应用程序必须将此参数设置为有效的 hLineApp 句柄,lineInitialize 函数返回。
 

dwAPIVersion

应用程序支持的 TAPI 的最高版本(不一定是某些特定行设备上 lineNegotiateAPIVersion 协商的值)。

lpTranslateCaps

指向加载 LINETRANSLATECAPS 结构的位置的指针。 在调用 lineGetTranslateCaps之前,应用程序必须设置此结构的 dwTotalSize 成员,以指示 TAPI 可用于返回信息的内存量。

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

返回值

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INIFILECORRUPT、LINEERR_OPERATIONFAILED、LINEERR_INVALAPPHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NODRIVER。

言论

注意

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

要求

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

另请参阅

基本电话服务参考

LINETRANSLATECAPS

TAPI 2.2 参考概述

lineInitializeEx

lineNegotiateAPIVersion