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