lineGetTranslateCaps 函数 (tapi.h)

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

语法

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

参数

hLineApp

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

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

dwAPIVersion

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

lpTranslateCaps

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

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

返回值

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

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

要求

   
目标平台 Windows
标头 tapi.h
Library Tapi32.lib
DLL Tapi32.dll

另请参阅

基本电话服务参考

LINETRANSLATECAPS

TAPI 2.2 参考概述

lineInitializeEx

lineNegotiateAPIVersion