GetUserDefaultGeoName 函数 (winnls.h)

检索用户作为国际标准化组织(ISO)3166-1 双字母代码的默认地理位置(如果可用)。 否则,联合国(UN)系列 M、数字 49(M.49)数字代码。

语法

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

参数

[out] geoName

指向缓冲区的指针,此函数应编写以 null 结尾的国际标准化组织 (ISO) 3166-1 双字母代码或联合国 (UN) 系列 M、数字 49 (M.49) 数字代码。

[in] geoNameCount

geoName 参数指定的缓冲区的大小。 如果此值为零,该函数仅返回函数将复制到输出缓冲区的字符数,但不会将用户的默认地理位置的名称写入缓冲区。

返回值

如果 geoNameCount 参数的值为零,函数将复制到输出缓冲区的字符数。 否则,函数复制到 geoName 参数所指定的缓冲区的字符数。

零表示函数失败。 若要获取扩展的错误信息,请调用 GetLastError,这将返回以下错误代码之一:

返回代码 描述
ERROR_INVALID_PARAMETER 参数值无效。
ERROR_BADDB 该函数无法从注册表读取信息。
ERROR_INSUFFICIENT_BUFFER geoName 参数指定的缓冲区对于字符串来说太小。

言论

如果用户的默认地理位置的 ISO 3166-1 代码为“XX”(表示尚未分配任何代码),但该位置确实分配了 UN M.49 代码,则将 M.49 代码作为小数字符串返回。

如果用户的默认地理位置的 ISO 3166-1 代码为“XX”(这表示尚未分配任何代码),但该位置确实分配了 UN M.49 代码,则将 M.49 代码作为小数字符串返回。

有关双字母 ISO 3166-1 代码的信息,请参阅 ISO 3166 国家/地区代码

有关数字 UN M.49 代码的信息,请参阅 标准国家/地区代码进行统计使用(M49)

要求

要求 价值
最低支持的客户端 Windows 10 版本 1709 [仅限桌面应用]
支持的最低服务器 Windows Server 2016 [仅限桌面应用]
目标平台 窗户
标头 winnls.h (包括 Windows.h)
Kernel32.lib
DLL Kernel32.dll

另请参阅