setUserGeoID 函数 (winnls.h)

[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 设置应用。 其他应用程序不应调用此函数。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winnls.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

GetUserGeoID

国家语言支持

国家语言支持函数

SetUserGeoName

地理位置表