lineGetCountryW 函数 (tapi.h)

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

语法

LONG lineGetCountryW(
  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。

言论

注意

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

要求

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

另请参阅

基本电话服务参考

LINECOUNTRYLIST

TAPI 2.2 参考概述

lineNegotiateAPIVersion