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

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

  • Статья

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

Синтаксис

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

Параметры

[out] geoName

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

[in] geoNameCount

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

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

Число символов, которые функция будет копировать в выходной буфер, если значение параметра geoNameCount равно нулю. В противном случае число символов, скопированных функцией в буфер, указанной параметром geoName.

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

Возвращаемый код Описание
ERROR_INVALID_PARAMETER Недопустимое значение параметра.
ERROR_BADDB Функция не могла считывать сведения из реестра.
ERROR_INSUFFICIENT_BUFFER Буфер, указывающий параметр geoName слишком мал для строки.

Замечания

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

Если код ISO 3166-1 для географического расположения пользователя по умолчанию имеет значение XX (которое указывает, что код не назначен), но расположение имеет код UN M.49, то код M.49 возвращается в виде десятичной строки.

Сведения о двухбуквовых кодах ISO 3166-1 см. в коды стран ISO 31666.

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

Требования

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

См. также