共用方式為


setUserGeoName 函式 (winnls.h)

將目前使用者的地理位置設定為指定的雙字母國際標準化組織 (ISO) 3166-1 代碼或數值 United (UN) 系列 M,數位 49 (M.49) 代碼。

語法

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

參數

[in] geoName

要為目前用戶設定之地理位置的雙字母 ISO 3166-1 或數值 UN M.49 代碼。 若要取得操作系統上可用的代碼,請呼叫 EnumSystemGeoNames

傳回值

如果成功,則傳回 TRUE ,否則傳回 FALSE

如果此函式不成功,請呼叫 GetLastError,這會傳回下列其中一個錯誤碼:

傳回碼 Description
ERROR_ACCESS_DISABLED_BY_POLICY
計算機或使用者的組策略已禁止此作業。
ERROR_INTERNAL_ERROR
函式中發生意外的錯誤。
ERROR_INVALID_PARAMETER
參數值無效。

備註

此函式會將特定使用者的地理位置寫入登錄,而不是特定應用程式。 此動作會影響使用者執行的其他應用程式的行為。 一般來說,只有在用戶明確要求變更時,才呼叫此函式,但不會基於單純的應用程式特定原因呼叫此函式。

如需雙字母 ISO 3166-1 代碼的相關信息,請參閱 國家/地區代碼 - ISO 3166。 如需數值 UN M.49 代碼的相關信息,請參閱 標準國家/地區代碼,以統計使用 (M49)

SetUserGeoName 適用於設計來變更使用者設定的應用程式,例如 Windows 設定應用程式。 其他應用程式不應該呼叫此函式。

規格需求

需求
最低支援的用戶端 Windows 10 1709 版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 winnls.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

EnumSystemGeoNames

GetUserDefaultGeoName

國家語言支援

國家語言支援函式

SetUserGeoID