RasGetCountryInfo

【勇芳软件工作室】汉化HomePreviousNext

[New - Windows NT]

RasGetCountryInfo功能从Windows Telephony国家/地区列表中检索国家/地区的拨号信息。

有关国家特定拨号信息和TAPI国家标识符的更多信息,请参阅Win32 Telephony(TAPI)程序员参考。

DWORD RasGetCountryInfo

LPRASCTRYINFO 【lpRasCtryInfo】,//接收国家信息的缓冲区
LPDWORD 【lpdwSize】//缓冲区的大小(以字节为单位)
); 

参数

【lpRasCtryInfo】

指向RASCTRYINFO结构的指针,可以接收国家/地区特定拨号信息,后跟国家/地区描述字符串的附加字节。在调用该函数之前,将结构的的dwSize成员设置为sizeof(RASCTRYINFO)以标识结构的版本。您还必须将dwCountryId成员设置为要获取信息的国家/地区的TAPI国家/地区标识符。

缓冲区的大小应至少为256字节。

【lpdwSize】

指向包含【lpRasCtryInfo】参数指向的缓冲区大小(以字节为单位)的变量。在返回时,函数将此变量设置为所需的字节数。

返回值

如果函数成功,返回值为零。

如果函数失败,则返回值可以是以下错误代码之一。

含义
ERROR_INVALID_USER_BUFFER【lpRasCtryInfo】指定的地址或缓冲区无效。
ERROR_INVALID_PARAMETERdwCountryId指向的结构的dwCountryId成员不是有效值。
ERROR_BUFFER_TOO_SMALL【lpdwSize】参数指定的【lpRasCtryInfo】缓冲区的大小不足以存储dwCountryId成员所标识的国家/地区的信息。该函数返回由【lpdwSize】指向的变量中所需的缓冲区大小。
ERROR_TAPI_CONFIGURATIONTAPI子系统信息已损坏。

备注

要在Windows Telephony列表中列举所有国家/地区的信息,请在RasGetCountryInfo初始配置中将RASCTRYINFO结构的dwCountryId成员设置为1。这将导致该函数返回列表中第一个国家/地区的信息。dwNextCountryId成员返回的值是列表中下一个国家/地区的国家/地区标识。在RasGetCountryInfo的重复调用中使用此值,直到dwNextCountryID返回零,表示列表中的最后一个国家/地区。

也可以看看

RASCTRYINFO