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 |