На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetLocaleInfo



The GetLocaleInfo function retrieves information about a locale.

int GetLocaleInfo(

LCID Locale, // locale identifier
LCTYPE LCType, // type of information
LPTSTR lpLCData, // address of buffer for information
int cchData // size of buffer
);


Parameters

Locale

Specifies the locale to retrieve information for. This parameter can be a locale identifier created by the MAKELCID macro, or one of the following predefined values:

LOCALE_SYSTEM_DEFAULT Default system locale.
LOCALE_USER_DEFAULT Default user locale.


LCType

Specifies one of the LCTYPE constants to indicate the type of information to be retrieved.
All LCTYPE values are mutually exclusive, with the exception of LOCALE_NOUSEROVERRIDE. An application may use the binary-OR operator to combine LOCALE_NOUSEROVERRIDE with any other LCTYPE value. If passed such an LCType value, the function bypasses user overrides, and returns the system default value for the requested LCID.

lpLCData

Points to a buffer to receive the requested data.

cchData

Specifies the size, in bytes (ANSI version) or characters (Unicode version), of the lpLCData buffer. If cchData is zero, the function returns the number of bytes or characters required to hold the information, and the buffer pointed to by lpLCData is not used.



Return Values

If the function succeeds, the return value is the number of bytes (ANSI version) or characters (Unicode version) written to the destination buffer, or if the cchData parameter is zero, the number of bytes or characters required to hold the locale information.
If the function fails, the return value is zero. To get extended error information, call GetLastError. GetLastError may return one of the following error codes:

ERROR_INSUFFICIENT_BUFFER
ERROR_INVALID_FLAGS
ERROR_INVALID_PARAMETER


Remarks

The GetLocaleInfo function always retrieves information in text format. If the information is a numeric value, the function converts the number to text using decimal notation.

See Also

GetStringTypeA, GetStringTypeEx, GetStringTypeW, GetSystemDefaultLCID, GetUserDefaultLCID, SetLocaleInfo, MAKELCID


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetLocaleInfo



Функция GetLocaleInfo извлекает информацию о месте действия.

int GetLocaleInfo(

МЕСТО действия LCID, // место действия идентификатора LCTYPE LCType, // типа информации LPTSTR lpLCData, // адреса буфера для информации размера int cchData // буфера
);


Параметры

Место действия

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

По умолчанию системное место действия LOCALE_SYSTEM_DEFAULT.
место действия пользователя Умолчания LOCALE_USER_DEFAULT.


LCType

Определяет одну из констант LCTYPE, чтобы указывать тип информации, которая нужно извлекаться.
Все величины LCTYPE взаимно исключительные, за исключением LOCALE_NOUSEROVERRIDE. Приложение может использовать двоичный код-ИЛИ оператор, чтобы объединять LOCALE_NOUSEROVERRIDE с любой другой величиной LCTYPE. Если пройдено такая величина LCType, функция обходит пользователя аннулирует, и возвращает системное значение по умолчанию для запрошенного LCID.

lpLCData

Точки на буфер, чтобы получать запрошенные данные.

cchData

Определяет размер, в байтах (версия ANSI) или символы (версия Уникода), буфера lpLCData. Если cchData - нуль, функция возвращает количество байтов или символов требовавшихся, чтобы хранить информацию, и буфер указывался, чтобы lpLCData не использован.



Обратные Величины

Если функция добивается успеха, обратная величина - количество байтов (версия ANSI) или символы (версия Уникода) записанного в буфер расположения, или если параметр cchData - нуль, количество байтов или символов требовавшиеся, чтобы хранить место действия информации.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError. GetLastError МОЖЕТ возвращать один из следующих кодов ошибки:

ERROR_INSUFFICIENT_BUFFER ERROR_INVALID_FLAGS ERROR_INVALID_PARAMETER


Замечания

Функция GetLocaleInfo всегда извлекает информацию в текстовый формат. Если информация является числовой величиной, функция преобразовывает число в текст, использовавший десятичную нотацию.

Смотри Также

GetStringTypeA, GetStringTypeEx, GetStringTypeW, GetSystemDefaultLCID, GetUserDefaultLCID, SetLocaleInfo, MAKELCID


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz