Windows C++ Locale Function
int GetGeoInfo(GEOID GeoId, GEOTYPE GeoType, LPTSTR lpGeoData, int cchData, LANGID language);
int GetGeoInfoA(GEOID GeoId, GEOTYPE GeoType, LPSTR lpGeoData, int cchData, LANGID language);
int GetGeoInfoW(GEOID GeoId, GEOTYPE GeoType, LPWSTR lpGeoData, int cchData, LANGID language);
Internationalization (I18n) Function Overview
The GetGeoInfo function retrieves GeoType information about the location GeoId,
in the language specified by language, and stores
the result in the buffer pointed to by lpGeoData. If cchData is non-zero,
then it specifies the size, in TCHARs, of the lpGeoData buffer, and the
return will be the number of TCHARs written to the buffer. If cchData is
0, then GetGeoInfo will return the number of TCHARs required
to hold the information, including the null terminator, but will not store the data.
If language is NULL, then the returned information will be in the
system's default UI language.
GetGeoInfoA is the narrow version of the function,
storing a single or multibyte character string in the buffer pointed to be lpGeoData,
and where cchData and the return value are single-byte length values.
GetGeoInfoW is the wide version of the function,
storing a wide-character string in the buffer pointed to be lpGeoData,
and where cchData and the return value are wide-character (WCHAR)
length values.
See the MSDN Library for additional information.
I18n Issues
Use the appropriate version of the function as required for internationalization support, noting the following:
Formulate the correct language id to pass into GetGeoInfo;
do not pass in NULL for the language, as in an internationalized application, the program's language may differ from the system's language.
Ensure that cchData is correct for the chosen platform; bytes for the narrow version and WCHARs for the wide version. See Locale-Sensitive Length Functions
for a discussion on multibyte and wide character sizes.
Note that GetGeoInfo is supported only on Windows XP, Windows Server 2003, and
Windows Me.
Recommended Replacements*
When possible, use the Generic version of the function, rather than the narrow or wide versions, and let the Windows #define UNICODE switch determine which version of the function will be called.
*If you're already using the recommended function, see I18n Issues for other reasons why Globalyzer is detecting the function.
|
