getUserDefaultGeoName 函数 (winnls.h)

检索国际标准化组织 (ISO) 3166-1 代码或数字联合国 (联合国) 系列 M,编号 49 (M.49) 用户的默认地理位置。

语法

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

参数

[out] geoName

指向缓冲区的指针,此函数应在缓冲区中为用户的默认地理位置编写以 null 结尾的双字母 ISO 3166-1 或数字 UN M.49 代码。

[in] geoNameCount

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

返回值

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

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

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

注解

有关双字母 ISO 3166-1 代码的信息,请参阅 国家/地区代码 - ISO 3166。 有关数字 UN M.49 代码的信息,请参阅 用于统计使用的标准国家或地区代码 (M49)

要求

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

另请参阅

GetUserGeoID

国家语言支持

国家语言支持函数

SetUserGeoName