DWORD RasGetCountryInfo(
_Inout_ LPRASCTRYINFO lpRasCtryInfo,
_Inout_ LPDWORD lpdwSize
);
說明
該函數用於從Windows國家/地區電話列表中獲取國家/地區特定的撥號信息。詳細瞭解國家/地區特定撥號信息點擊查看Telephony Application Programming Interface (TAPI)。
參數
lpRasCtryInfo [in, out]
指向一個用於接收國家/地區特定撥號信息的RASCTRYINFO結構,結構末尾緊隨一些附加字節用於存儲國家/地區描述字符串。
調用前將結構中的dwSize值設置爲sizeof(RASCTRYINFO),另外將dwContryId設置爲TAPI國家/地區識別碼。
至少要爲該緩衝分配256字節。
lpdwSize [in, out]
該參數用於傳入lpRasCtryInfo指向的緩衝長度,函數返回時接收實際需要的緩衝字節數。
返回值
成功時返回ERROR_SUCCESS。
失敗時返回以下列表中的值之一或來自Routing and Remote Access Error Codes或Winerror.h中定義的錯誤碼。
值 | 含義 |
---|---|
ERROR_INVALID_USER_BUFFER | lpRasCtryInfo指向的緩衝地址無效。 |
ERROR_INVALID_PARAMETER | RASCTRYINFO結構中的成員dwCountryId值不正確。 |
ERROR_BUFFER_TOO_SMALL | lpRasCtryInfo指向的緩衝除去前面RASCTRYINFO結構長度後,剩餘的空間不夠存儲dwCountryId成員指定的國家/地區描述串。可以通過lpdwSize指向的變量得到需要的字節數。 |
ERROR_TAPI_CONFIGURATION | TAPI子系統信息損壞。 |
注意事項
在首次調用該函數時,將RASCTRYINFO結構的成員dwCountryId設置爲1,函數將返回國家/地區列表中的第一個國家/地區信息。同時RASCTRYINFO結構中的成員dwNextCountryID指向下一個國家/地區信息。重複使用dwNextCountryID來調用該函數可以枚舉所有國家/地區信息。當dwNextCountryID爲0時到達最後一個項。
系統支持
客戶端最小支持 | Windows 2000專業版 |
---|---|
服務端最小支持 | Windows 2000 Server |
Header | Ras.h |
Library | Rasapi32.lib |
DLL | Rasapi32.dll |
Unicode和ANSI名稱 | RasGetCountryInfoW(Unicode)和RasGetCountryInfoA(ANSI) |