Функция SetUserGeoName (winnls.h)

  • Статья

Задает географическое расположение для текущего пользователя в соответствии с указанным двухбуквенный код Международной организации по стандартизации (ISO) 3166-1 или числовой код Серии M, номер 49 (M.49).

Синтаксис

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

Параметры

[in] geoName

Двухбуквенный код ISO 3166-1 или числовой код UN M.49 для географического расположения, заданного для текущего пользователя. Чтобы получить коды, доступные в операционной системе, вызовите EnumSystemGeoNames.

Возвращаемое значение

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае.

Если эта функция не выполняется, вызовите Метод GetLastError, который может вернуть один из следующих кодов ошибок:

Код возврата Описание
ERROR_ACCESS_DISABLED_BY_POLICY
 Эта операция запрещена групповой политикой компьютера или пользователя.
ERROR_INTERNAL_ERROR
 В функции произошла непредвиденная ошибка.
ERROR_INVALID_PARAMETER
 Недопустимое значение параметра.

Комментарии

Эта функция записывает в реестр географическое расположение конкретного пользователя, а не конкретного приложения. Это действие влияет на поведение других приложений, запускаемых пользователем. Как правило, эту функцию можно вызывать только в том случае, если пользователь явно запросил изменения, но не по причинам, зависящим от приложения.

Сведения о двухбуквенном коде ISO 3166-1 см. в разделе Коды стран — ISO 3166. Сведения о числовых кодах UN M.49 см. в разделе Стандартные коды стран или областей для статистического использования (M49).

SetUserGeoName предназначен для использования приложениями, предназначенными для изменения параметров пользователя, например приложением "Параметры Windows". Другие приложения не должны вызывать эту функцию.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1709 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header winnls.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

EnumSystemGeoNames

GetUserDefaultGeoName

Поддержка национальных языков

Функции поддержки национальных языков

SetUserGeoID