Функция SetUserGeoID (winnls.h)
[SetUserGeoID доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте SetUserGeoName.
]
Задает идентификатор географического расположения для пользователя. Этот идентификатор должен иметь одно из значений, описанных в таблице географических расположений.
Синтаксис
BOOL SetUserGeoID(
[in] GEOID GeoId
);
Параметры
[in] GeoId
Идентификатор географического расположения пользователя.
Возвращаемое значение
Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае.
Windows XP, Windows Server 2003: эта функция не предоставляет расширенные сведения об ошибке. Таким образом, приложение не может вызывать GetLastError после этой функции. Если приложение вызывает GetLastError, оно может вернуть значение, заданное ранее вызванной функцией.
Если эта функция не выполняется, приложение может вызвать Метод GetLastError, который может возвращать один из следующих кодов ошибок:
- ERROR_ACCESS_DISABLED_BY_POLICY. Эта операция запрещена групповой политикой компьютера или пользователя.
- ERROR_INTERNAL_ERROR. В функции произошла непредвиденная ошибка.
- ERROR_INVALID_PARAMETER. Любое из значений параметров было недопустимым.
Комментарии
Эта функция записывает в реестр географическое расположение конкретного пользователя, а не конкретного приложения. Это действие влияет на поведение других приложений, выполняемых пользователем. Как правило, приложение должно вызывать эту функцию только в том случае, если пользователь явно запросил изменения, но не по причинам, зависящим от конкретного приложения.
SetUserGeoID предназначен для использования приложениями, предназначенными для изменения параметров пользователя, например приложением "Параметры Windows". Другие приложения не должны вызывать эту функцию.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winnls.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |