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 |