Функция 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, который может возвращать один из следующих кодов ошибок:

Код возврата Описание
ERROR_INVALID_PARAMETER
 Недопустимое значение параметра.
ERROR_BADDB
 Функции не удалось прочитать сведения из реестра.
ERROR_INSUFFICIENT_BUFFER
 Буфер, который указывает параметр 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

См. также

GetUserGeoID

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

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

SetUserGeoName