Поделиться через


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

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

Синтаксис

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

Параметры

[in] geoName

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

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

Возвращает значение TRUE , если успешно или false в противном случае.

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

Код возврата Description
ERROR_ACCESS_DISABLED_BY_POLICY
Групповая политика компьютера или пользователя запретила эту операцию.
ERROR_INTERNAL_ERROR
В функции произошла непредвиденная ошибка.
ERROR_INVALID_PARAMETER
Недопустимое значение параметра.

Замечания

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

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

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

Требования

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

См. также

EnumSystemGeoNames

GetUserDefaultGeoName

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

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

SetUserGeoID