| 术语 | getlocaleinfoex |
| 释义 | GetLocaleInfoEx 语法： int GetLocaleInfoEx( __in LPCWSTR lpLocaleName, __in LCTYPE LCType, __out LPWSTR lpLCData, __in int cchData ); GetLocaleInfoEx功能 检索信息通过名称指定的语言环境。 注意：应用程序应优先调用此函数来GetLocaleInfo运行而设计的，如果仅在Windows Vista和更高版本。 注意：此功能可以检索数据的变化之间的版本，例如，由于自定义区域。如果应用程序必须坚持或传输数据，请参阅使用持久性本地化数据。 参数 lpLocaleName [in] 可选。指针区域的名称，或以下预定义值之一。 LOCALE_NAME_INVARIANT LOCALE_NAME_SYSTEM_DEFAULT LOCALE_NAME_USER_DEFAULT LCType [in] 地区信息的检索。有关详细的定义，见GetLocaleInfo LCType参数。 lpLCData [out] 可选。缓冲区指针在本函数检索要求的区域设置信息。这不使用指针，如果cchData设置为0。 cchData [in] 大小，这表明在字符的数据缓冲区lpLCData。另外，应用程序可以设置为0参数。在这种情况下，该函数不使用lpLCData参数并返回所需的缓冲区大小，包括终止空字符。 返回值 返回的语言环境中检索数据缓冲区的字符数，如果成功，cchData是一个非零值。如果函数成功，cchData不为零，并LOCALE_RETURN_NUMBER指定，返回值是在数据缓冲区检索的整数，也就是为函数或4 ANSI版本的Unicode版本2的大小。如果函数成功与cchData值为0，返回值是所需的大小，在包括一个空字符，字符，为区域数据缓冲区。 该函数返回0，如果没有成功。为了获得更多错误信息，应用程序可以调用GetLastError函数，可以返回以下错误代码之一： ERROR_INSUFFICIENT_BUFFER。阿提供的缓冲区大小不够大，或者被错误地设置为NULL。 ERROR_INVALID_FLAGS。旗帜提供的值不是有效的。 ERROR_INVALID_PARAMETER。该参数值的任何无效。 备注 在本功能操作，看到GetLocaleInfo在备注有关资料。 注意：即使LCType参数是LOCALE_FONTSIGNATURE，cchData和函数返回指定的字符数仍。当应用程序调用作为LOCALE_FONTSIGNATURE指定LCType GetLocaleInfoEx，cchData可以安全地指定为sizeof(LOCALESIGNATURE)/ sizeof(宽字符)。 下面的例子正确处理与非缓冲区大小，文本值： int ret; DWORD value; CALID calid; ret = GetLocaleInfoEx(LOCALE_NAME_USER_DEFAULT, LOCALE_ICALENDARTYPE | LOCALE_RETURN_NUMBER, (LPWSTR) &value, sizeof(calid) / sizeof(WCHAR)); calid = value; LOCALESIGNATURE LocSig; ret = GetLocaleInfoEx( LOCALE_USER_DEFAULT, LOCALE_FONTSIGNATURE, (LPWSTR)&LocSig, sizeof(LocSig) / sizeof(WCHAR) ); 实例 例子显示了使用这功能，可以找到免入息审查：产品名称为基础的API采样和免入息审查：国际化域名(IDN)的缓解示例。 要求： client最低支持Vista server最低支持 Windows Server 2008 HeaderWinnls.h(头文件：winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 国家语言支持 国家语言支持功能 检索和设置区域设置信息 GetLocaleInfo GetSystemDefaultLocaleName GetUserDefaultLocaleName SetLocaleInfo 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月12号 ＝＝英文原文＝＝GetLocaleInfoEx Function Retrieves information about a locale specified by name. Note The application should call this function in preference to GetLocaleInfo if designed to run only on Windows Vista and later. Note This function can retrieve data that changes between releases, for example, due to a custom locale. If your application must persist or transmit data, see Using Persistent Locale Data . Syntax int GetLocaleInfoEx( __in LPCWSTR lpLocaleName, __in LCTYPE LCType, __out LPWSTR lpLCData, __in int cchData ); Parameters lpLocaleName [in] Optional. Pointer to a locale name , or one of the following predefined values. LOCALE_NAME_INVARIANT LOCALE_NAME_SYSTEM_DEFAULT LOCALE_NAME_USER_DEFAULT LCType [in] The locale information to retrieve. For detailed definitions, see the LCType parameter of GetLocaleInfo . lpLCData [out] Optional. Pointer to a buffer in which this function retrieves the requested locale information. This pointer is not used if cchData is set to 0. cchData [in] Size, in characters, of the data buffer indicated by lpLCData. Alternatively, the application can set this parameter to 0. In this case, the function does not use the lpLCData parameter and returns the required buffer size, including the terminating null character. Return Value Returns the number of characters retrieved in the locale data buffer if successful and cchData is a nonzero value. If the function succeeds, cchData is nonzero, and LOCALE_RETURN_NUMBER is specified, the return value is the size of the integer retrieved in the data buffer, that is, 2 for the Unicode version of the function or 4 for the ANSI version. If the function succeeds and the value of cchData is 0, the return value is the required size, in characters including a null character, for the locale data buffer. The function returns 0 if it does not succeed. To get extended error information, the application can call GetLastError , which can return one of the following error codes: ERROR_INSUFFICIENT_BUFFER. A supplied buffer size was not large enough, or it was incorrectly set to NULL. ERROR_INVALID_FLAGS. The values supplied for flags were not valid. ERROR_INVALID_PARAMETER. Any of the parameter values was invalid. Remarks For the operation of this function, see the pertinent information in Remarks for GetLocaleInfo . Note Even when the LCType parameter is specified as LOCALE_FONTSIGNATURE, cchData and the function return are still character counts. When an application calls GetLocaleInfoEx with LCType specified as LOCALE_FONTSIGNATURE, cchData can be safely specified as sizeof(LOCALESIGNATURE) / sizeof(WCHAR). The following examples deal correctly with the buffer size for non-text values: int ret; DWORD value; CALID calid; ret = GetLocaleInfoEx(LOCALE_NAME_USER_DEFAULT, LOCALE_ICALENDARTYPE | LOCALE_RETURN_NUMBER, (LPWSTR) &value, sizeof(calid) / sizeof(WCHAR)); calid = value; LOCALESIGNATURE LocSig; ret = GetLocaleInfoEx( LOCALE_USER_DEFAULT, LOCALE_FONTSIGNATURE, (LPWSTR)&LocSig, sizeof(LocSig) / sizeof(WCHAR) ); Examples Examples showing the use of this function can be found in NLS: Name-based APIs Sample and NLS: Internationalized Domain Name (IDN) Mitigation Sample . Requirements Minimum supported clientWindows Vista Minimum supported serverWindows Server 2008 HeaderWinnls.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also National Language Support National Language Support Functions Retrieving and Setting Locale Information GetLocaleInfo GetSystemDefaultLocaleName GetUserDefaultLocaleName SetLocaleInfo Send comments about this topic to Microsoft Build date: 7/12/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/dd318103(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。