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 |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |