GetUserDefaultGeoName 函式 (winnls.h)
擷取兩個字母的標準化組織 (ISO) 3166-1 程式代碼或數值 United The United Organization (UN) Series M,Number 49 (M.49) code for the default 地理位置。
語法
int GetUserDefaultGeoName(
[out] LPWSTR geoName,
[in] int geoNameCount
);
參數
[out] geoName
緩衝區的指標,此函式應針對用戶的預設地理位置,寫入以 Null 終止的雙字母 ISO 3166-1 或數值 UN M.49 程式代碼。
[in] geoNameCount
geoName 參數所指定的緩衝區大小。 如果此值為零,函式只會傳回函式會複製到輸出緩衝區的字元數,但不會將用戶的預設地理位置名稱寫入緩衝區。
傳回值
如果 geoNameCount 參數的值是零,則函式會複製到輸出緩衝區的字元數。 否則,函式複製到 geoName 參數所指定之緩衝區的字元數。
零表示函式失敗。 若要取得擴充錯誤資訊,請呼叫 GetLastError,以傳回下列其中一個錯誤碼:
傳回碼 | Description |
---|---|
|
參數值無效。 |
|
函式無法從登錄讀取資訊。 |
|
geoName 參數指定的緩衝區對字串而言太小。 |
備註
如需兩個字母 ISO 3166-1 代碼的相關信息,請參閱 國家/地區代碼 - ISO 3166。 如需數值 UN M.49 代碼的相關信息,請參閱 標準國家或地區代碼,以用於統計用途 (M49) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1709 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winnls.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |