Функция GetUserDefaultGeoName (winnls.h)
Извлекает двухбуквенный код Международной организации по стандартизации (ISO) 3166-1 или числовой код серии M, номер 49 (M.49) Организации Объединенных Наций (ООН) для географического расположения пользователя по умолчанию.
Синтаксис
int GetUserDefaultGeoName(
[out] LPWSTR geoName,
[in] int geoNameCount
);
Параметры
[out] geoName
Указатель на буфер, в котором эта функция должна записать двухбуквенный код 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 |
| Header | winnls.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |