GetGeoInfoEx 函式 (winnls.h)
擷取您使用兩個字母國際標準化組織 (ISO) 3166-1 代碼或數位 United United Organization (UN) Series M、Number 49 (M.49) code 指定之地理位置的相關信息。
語法
int GetGeoInfoEx(
[in] PWSTR location,
[in] GEOTYPE geoType,
[out, optional] PWSTR geoData,
[in] int geoDataCount
);
參數
[in] location
要取得資訊的地理位置的雙字母 ISO 3166-1 或數值 UN M.49 代碼。 若要取得操作系統上可用的程序代碼，請呼叫 EnumSystemGeoNames。
[in] geoType
您想要擷取的信息類型。 可能的值是由 SSGEOTYPE 列舉所定義。 SYSGEOTYPE 列舉的下列值不應該與 GetGeoInfoEx 搭配使用：
-
GEO_ID
提供這個值的目的，是為了與舊版相容。 請勿在新應用程式中使用此值，但請改用 GEO_NAME 。
-
GEO_LCID
GetGeoInfoEx 函式不支援此值。
-
GEO_NATION
GetGeoInfoEx 函式不支援此值。
-
GEO_RFC1766
GetGeoInfoEx 函式不支援此值。
[out, optional] geoData
GetGeoInfoEx 應該寫入要求信息的緩衝區指標。
[in] geoDataCount
GeoData 參數指向的緩衝區大小，以字元為單位。 將此參數設定為 0，以指定函式只應該傳回儲存要求資訊所需的緩衝區大小，而不需要將要求的資訊寫入緩衝區。
傳回值
函式寫入輸出緩衝區的地理位置資訊位元組數目。 如果 geoDataCount 為 0，函式會傳回保存資訊所需的緩衝區大小，而不需要將資訊寫入緩衝區。
0 表示函式未成功。 若要取得擴充錯誤資訊，請呼叫 GetLastError，以傳回下列其中一個錯誤碼：
| 傳回碼 | Description |
|---|---|
|
提供的緩衝區大小不夠大，或設定為 NULL 不正確。 |
|
參數值無效。 |
|
為旗標的值無效。 |
備註
如需兩個字母 ISO 3166-1 代碼的相關信息，請參閱 國家/地區代碼 - ISO 3166。 如需數值 UN M.49 代碼的相關信息，請參閱 標準國家或地區代碼，以用於統計用途 (M49) 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1709 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winnls.h |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |