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


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

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

Syntax

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

Parameters

[out] geoName

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

[in] geoNameCount

The size of the buffer that the geoName parameter specifies. Если это значение равно нулю, функция возвращает только количество символов, которые будут копироваться в выходной буфер, но не записывает имя географического расположения пользователя по умолчанию в буфер.

Return value

The number of characters the function would copy to the output buffer if the value of the geoNameCount parameter is zero. Otherwise, the number of characters that the function copied to the buffer that the geoName parameter specifies.

Ноль указывает, что функция завершилась ошибкой. To get extended error information, call GetLastError, which can return one of the following error codes:

Return code Description
ERROR_INVALID_PARAMETER Недопустимое значение параметра.
ERROR_BADDB Функция не могла считывать сведения из реестра.
ERROR_INSUFFICIENT_BUFFER The buffer that the geoName parameter specifies is too small for the string.

Remarks

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

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

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

Requirements

Requirement Value
минимальные поддерживаемые клиентские Windows 10 версии 1709 [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2016 [только классические приложения]
Target Platform Windows
Header winnls.h (включая Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also