[SetUserGeoID 可用于“要求”部分中指定的作系统。 在后续版本中可能会更改或不可用。 请改用 SetUserGeoName。
]
设置用户的地理位置标识符。 此标识符应具有 地理位置表中所述的值之一。
Syntax
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 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | winnls.h （包括 Windows.h） |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |