Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Извлекает географическое расположение пользователя по умолчанию в качестве международной организации по стандартизации (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 |