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 |