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,这会返回以下错误代码之一:
返回代码 | 说明 |
---|---|
|
参数值无效。 |
|
函数无法从注册表中读取信息。 |
|
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 |