[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_PARAMETER | dwCountryId指向的结构的dwCountryId成员不是有效值。 |
ERROR_BUFFER_TOO_SMALL | 由【lpdwSize】参数指定的【lpRasCtryInfo】缓冲区的大小不足以存储dwCountryId成员所标识的国家/地区的信息。该函数返回由【lpdwSize】指向的变量中所需的缓冲区大小。 |
ERROR_TAPI_CONFIGURATION | TAPI子系统信息已损坏。 |
备注
要在Windows Telephony列表中列举所有国家/地区的信息,请在RasGetCountryInfo初始配置中将RASCTRYINFO结构的dwCountryId成员设置为1。这将导致该函数返回列表中第一个国家/地区的信息。dwNextCountryId成员返回的值是列表中下一个国家/地区的国家/地区标识。在RasGetCountryInfo的重复调用中使用此值,直到dwNextCountryID返回零,表示列表中的最后一个国家/地区。
也可以看看