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 設定應用程式。其他應用程式不應該呼叫此函式。