SetUserGeoID 函式 (winnls.h)
[SetUserGeoID 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 SetUserGeoName。
]
設定使用者的地理位置識別碼。 此識別碼應具有 地理位置資料表中所述的其中一個值。
語法
BOOL SetUserGeoID(
[in] GEOID GeoId
);
參數
[in] GeoId
使用者的地理位置識別碼。
傳回值
如果成功或 FALSE，則傳回 TRUE 。否則傳回 TRUE 。
Windows XP、Windows Server 2003：此函式不提供延伸的錯誤資訊。 因此，應用程式不適合在此函式之後呼叫 GetLastError 。 如果應用程式確實呼叫 GetLastError，它可以傳回一些先前呼叫的函式所設定的值。
如果此函式不成功，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：
- ERROR_ACCESS_DISABLED_BY_POLICY。 電腦或使用者的群組原則已禁止此作業。
- ERROR_INTERNAL_ERROR。 函式中發生意外的錯誤。
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
備註
此函式會將特定使用者的地理位置寫入登錄，而不是特定應用程式。 此動作會影響使用者執行的其他應用程式行為。 因此，只有在使用者明確要求變更時，應用程式才應該呼叫此函式，但不應該只基於應用程式特定的原因呼叫。
SetUserGeoID 適用于設計來變更使用者設定的應用程式，例如 Windows 設定應用程式。 其他應用程式不應該呼叫此函式。
規格需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winnls.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |