lineGetCountry 函数 (tapi.h)

  • 项目

lineGetCountry 函数提取与指定国家/地区、国家/地区列表中的第一个国家/地区或所有国家/地区相关的存储拨号规则和其他信息。

语法

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

参数

dwCountryID

国家/地区标识符 (不是要为其获取信息的国家/地区的国家/地区代码) 。 如果指定了值 1，则会获取有关国家/地区列表中的第一个国家/地区的信息。 如果指定值 0，则会 (获取有关所有国家/地区的信息，这可能需要大量内存 — 20 KB 或更多) 。

dwAPIVersion

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

lpLineCountryList

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

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

返回值

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INIFILECORRUPT、LINEERR_OPERATIONFAILED、LINEERR_INVALCOUNTRYCODE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER。

要求

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

另请参阅

基本电话服务参考

LINECOUNTRYLIST

TAPI 2.2 参考概述

lineNegotiateAPIVersion