LANGID GetSystemDefaultUILanguage()
GetSystemDefaultUILanguage 函数检索原始系统安装语言的 LANGID。
返回值
-
如果函数运行成功,则返回值是系统默认 UI 语言的 LANGID。
-
如果运行失败,则返回值为 0。
另请参阅
LANGID GetUserDefaultUILanguage
GetUserDefaultUILanguage 函数检索当前用户的 UI 语言选择的 LANGID。
返回值
-
如果函数运行成功,则返回值是当前用户的 UI 语言的 LANGID。
-
如果运行失败,则返回值为 0。
另请参阅
EnumUILanguages
BOOL EnumUILanguages
UILANGUAGE_ENUMPROC lpUILanguageEnumProc, // pointer to enumeration callback function
DWORD dwFlags, // flags - reserved
LONG_PTR lParam, // application-defined parameter
);
EnumUILanguages 函数枚举系统中所有可用的 UI 语言。dwFlags 参数的值必须为零。此函数通过将语言标识符一次一个传递到指定的应用程序定义的回调函数来枚举 UI 语言。此过程将一直持续,直至到达最后一个语言标识符或回调函数返回 FALSE 为止。
参数
lpUILanguageEnumProc
指向应用程序定义的回调函数。EnumUILanguages 函数通过重复调用此回调函数来枚举语言标识符。有关详细信息,请参阅 EnumUILanguagesProc 回调函数。
dwFlags
保留。必须为零。
lParam
指定传递给回调函数的应用程序定义的值。可在检查错误时使用此参数。
返回值
-
如果函数运行成功,则返回值为 TRUE。
-
如果运行失败,则返回值为 FALSE。要查看更多的错误信息,可以调用 GetLastError。
GetLastError
可能返回以下错误代码之一:
-
ERROR_BADDB
-
ERROR_INVALID_PARAMETER
-
ERROR_INVALID FLAGS
另请参阅
EnumUILanguagesProc
BOOL CALLBACK EnumUILanguagesProc
(
LPTSTR lpUILanguageString // pointer to UI language string
LONG_PTR lParam // application-defined parameter
);
EnumUILanguagesProc 函数是一个应用程序定义的回调函数。它作为 EnumUILanguages 函数的调用结果被调用,并且会接收指向包含 UI 语言标识符的字符串缓冲区的指针以及传递给 EnumUILanguages 的应用程序定义的参数。
参数
lpUILanguageString
一个指向字符串缓冲区的指针,其中包含以 Null 结尾的 UI 语言标识符字符串。请注意,lpUILanguageString 应为 Unicode (W) 版本的 EnumUILanguagesProc 的 LPWSTR,以及 ANSI (A) 版本的 EnumUILanguagesProc 的 LPSTR。
lParam
指定传递给 EnumUILanguages 函数的应用程序定义的参数。可在检查错误时使用此参数。
返回值
-
要继续枚举,回调函数应返回 TRUE。
-
要停止枚举,回调函数应返回 FALSE。
备注
- EnumUILanguagesProc 是应用程序定义的函数名称的占位符。
-
EnumUILanguagesProc 函数可执行任何所需的任务。
- 应用程序通过将其地址传递给 EnumUILanguages 函数来注册 EnumUILanguagesProc 函数。
-
类型 UILANGUAGE_ENUMPROC 的值是一个指向 EnumUILanguagesProc 函数的指针。
另请参阅
IsValidLanguageGroup
BOOL IsValidLanguageGroup(
LGRPID LanguageGroup, // language group identifier to validate
DWORD dwFlags // specifies validity test
);
IsValidLanguageGroup 可对语言组标识符应用有效性测试。dwFlags 参数可确定有效性测试的性质。目前,此函数可测试在调用系统中是否已安装了语言组标识符或语言组标识符是否受支持。
参数
LanguageGroup
指定要进行验证的语言组标识符。此参数可以是下列值之一:
-
LGRPID_WESTERN_EUROPE
-
LGRPID_CENTRAL_EUROPE
-
LGRPID_BALTIC
-
LGRPID_GREEK
-
LGRPID_CYRILLIC
-
LGRPID_TURKISH
-
LGRPID_JAPANESE
-
LGRPID_KOREAN
-
LGRPID_TRADITIONAL_CHINESE
-
LGRPID_SIMPLIFIED_CHINESE
-
LGRPID_THAI
-
LGRPID_HEBREW
-
LGRPID_ARABIC
-
LGRPID_VIETNAMESE
-
LGRPID_INDIC
dwFlags
指定要应用到语言组标识符的有效性测试。此参数可以是下列值之一:
值的含义
- LGRPID_INSTALLED 测试是否支持并已安装了语言组标识符。
-
LGRPID_SUPPORTED 测试是否支持语言组标识符。
返回值
-
如果语言组标识符传递指定的有效性测试,则返回值为 TRUE。
-
如果语言组标识符没有传递指定的有效性测试,则返回值为 FALSE。
备注
-
如果指定了 LGRPID_INSTALLED 标记并且此函数返回 TRUE,则此系统支持并已安装了语言组标识符。
-
如果指定了 LGRPID_SUPPORTED 标记并且此函数返回 TRUE,则此版本支持语言组标识符,但系统中不一定已安装。
另请参阅
EnumSystemLanguageGroups
BOOL EnumSystemLanguageGroups(
LANGUAGEGROUP_ENUMPROC lpLanguageGroupEnumProc, // pointer to enumeration callback function
DWORD dwFlags // language groups to enumerate
LONG_PTR lParam, // application-defined parameter
);
EnumSystemLanguageGroups 函数枚举系统安装或支持的语言组。dwFlags 参数确定函数是否枚举了已安装或受支持的系统语言组。此函数通过将语言组标识符一次一个传递到指定的应用程序定义的回调函数来枚举语言组。此过程将一直持续,直至到达最后一个语言组标识符或回调函数返回 FALSE 为止。
参数
lpLanguageGroupEnumProc
指向应用程序定义的回调函数。EnumSystemLanguageGroups 函数通过重复调用此回调函数来枚举语言组标识符。
有关详细信息,请参阅 EnumLanguageGroupsProc 回调函数。
dwFlags
指定要枚举的语言组标识符。此参数可以是下列值之一:
值的含义
- LGRPID_INSTALLED 仅枚举已安装的语言组标识符。
-
LGRPID_SUPPORTED 枚举所有受支持的语言组标识符。
lParam
指定传递给回调函数的应用程序定义的值。可在检查错误时使用此参数。
返回值
-
如果函数运行成功,则返回值为 TRUE。
-
如果运行失败,则返回值为 FALSE。要查看更多的错误信息,可以调用 GetLastError。
GetLastError 可返回以下错误代码之一:
-
ERROR_BADDB
-
ERROR_INVALID_PARAMETER
-
ERROR_INVALID FLAGS
另请参阅
EnumSystemLanguageGroupsProc
BOOL CALLBACK EnumLanguageGroupsProc(
LGRPID LanguageGroup, // language group identifier
LPTSTR lpLanguageGroupString, // pointer to language group identifier string
LPTSTR lpLanguageGroupNameString, // pointer to language group name string
DWORD dwFlags // flags
LONG_PTR lParam // application-defined parameter
);
EnumLanguageGroupsProc 函数是一个应用程序定义的回调函数。它作为 EnumSystemLanguageGroups 函数的调用结果被调用,并且会接收语言组标识符、指向包含语言组标识符的字符串缓冲区的指针、指向包含语言组名称的字符串缓冲区的指针、标记字段以及传递给 EnumSystemLanguageGroups 的应用程序定义的参数。
参数
LanguageGroup
指定语言组标识符。此参数可以是下列值之一:
-
LGRPID_WESTERN_EUROPE
-
LGRPID_CENTRAL_EUROPE
-
LGRPID_BALTIC
-
LGRPID_GREEK
-
LGRPID_CYRILLIC
-
LGRPID_TURKISH
-
LGRPID_JAPANESE
-
LGRPID_KOREAN
-
LGRPID_TRADITIONAL_CHINESE
-
LGRPID_SIMPLIFIED_CHINESE
-
LGRPID_THAI
-
LGRPID_HEBREW
-
LGRPID_ARABIC
-
LGRPID_VIETNAMESE
-
LGRPID_INDIC
lpLanguageGroupString
一个指向字符串缓冲区的指针,其中包含以 Null 结尾的语言组标识符字符串。请注意,lpLanguageGroupString 应为 Unicode (W) 版本的 EnumLanguageGroupsProc 的 LPWSTR,以及 ANSI (A) 版本的 EnumLanguageGroupsProc 的 LPSTR。
lpLanguageGroupNameString
一个指向字符串缓冲区的指针,其中包含以 Null 结尾的语言组名称字符串。请注意,lpUILanguageString 应为 Unicode (W) 版本的 EnumLanguageGroupsProc 的 LPWSTR,以及 ANSI (A) 版本的 EnumLanguageGroupsProc 的 LPSTR。
dwFlags
指出是否支持或是否已安装语言组标识符。此参数可以是下列值之一:
值的含义
-
LGRPID_INSTALLED 语言组标识符已安装。
-
LGRPID_SUPPORTED 语言组标识符受到支持并且已经安装。
lParam
指定传递给 EnumSystemLanguageGroups 函数的应用程序定义的参数。可在检查错误时使用此参数。
返回值
-
要继续枚举,回调函数应返回 TRUE。
-
要停止枚举,回调函数应返回 FALSE。
备注
-
LGRPID_INSTALLED 和 LGRPID_SUPPORTED 标记是相互排斥的。
- EnumLanguageGroupsProc 是应用程序定义的函数名称的占位符。
-
ERROR_INVALID FLAGS
-
ERROR_INVALID_PARAMETER
-
ERROR_INVALID FLAGS
另请参阅
EnumLanguageGroupLocales
BOOL EnumLanguageGroupLocales(
LANGGROUPLOCALE_ENUMPROC lpLangGroupLocaleEnumProc, // pointer to enumeration callback function
LGRPID LanguageGroup, // language group identifier
DWORD dwFlags // flags – reserved
LONG_PTR lParam, // application–defined parameter
);
EnumLanguageGroupLocales 函数枚举给定语言组中的区域设置。dwFlags 参数的值必须为零。此函数通过将区域设置标识符一次一个传递到指定的应用程序定义的回调函数来枚举语言组中的区域设置。此过程将一直持续,直至到达最后一个区域设置标识符或回调函数返回 FALSE 为止。
参数
lpLangGroupLocaleEnumProc
指向应用程序定义的回调函数。EnumLanguageGroupLocales 函数通过重复调用此回调函数来枚举给定语言组中的区域设置标识符。有关详细信息,请参阅 EnumLanguageGroupLocalesProc 回调函数。
LanguageGroup
指定要枚举的语言组标识符。此参数可以是下列值之一:
-
LGRPID_WESTERN_EUROPE
-
LGRPID_CENTRAL_EUROPE
-
LGRPID_BALTIC
-
LGRPID_GREEK
-
LGRPID_CYRILLIC
-
LGRPID_TURKISH
-
LGRPID_JAPANESE
-
LGRPID_KOREAN
-
LGRPID_TRADITIONAL_CHINESE
-
LGRPID_SIMPLIFIED_CHINESE
-
LGRPID_THAI
-
LGRPID_HEBREW
-
LGRPID_ARABIC
-
LGRPID_VIETNAMESE
-
LGRPID_INDIC
dwFlags
保留。必须为零。
lParam
指定传递给回调函数的应用程序定义的值。可在检查错误时使用此参数。
返回值
-
如果函数运行成功,则返回值为 TRUE。
-
如果运行失败,则返回值为 FALSE。要查看更多的错误信息,可以调用 GetLastError。
GetLastError
可能返回以下错误代码之一:
-
ERROR_BADDB
-
ERROR_INVALID_PARAMETER
-
ERROR_INVALID FLAGS
另请参阅
EnumLanguageGroupLocalesProc
CLass= api>BOOL CALLBACK EnumLanguageGroupLocalesProc(
LGRPID LanguageGroup, // language group identifier
LCID Locale, // locale identifier
LPTSTR lpLocaleString, // pointer to locale identifier string
LONG_PTR lParam // application-defined parameter
);
EnumLanguageGroupLocalesProc 函数是一个应用程序定义的回调函数。它作为 EnumLanguageGroupLocales 函数的调用结果被调用,并且会接收语言组标识符、区域设置标识符、指向包含区域设置标识符的字符串缓冲区的指针以及传递给 EnumLanguageGroupLocales 的应用程序定义的参数。
参数
LanguageGroup
指定要枚举的语言组标识符。此参数可以是下列值之一:
-
LGRPID_WESTERN_EUROPE
-
LGRPID_CENTRAL_EUROPE
-
LGRPID_BALTIC
-
LGRPID_GREEK
-
LGRPID_CYRILLIC
-
LGRPID_TURKISH
-
LGRPID_JAPANESE
-
LGRPID_KOREAN
-
LGRPID_TRADITIONAL_CHINESE
-
LGRPID_SIMPLIFIED_CHINESE
-
LGRPID_THAI
-
LGRPID_HEBREW
-
LGRPID_ARABIC
-
LGRPID_VIETNAMESE
-
LGRPID_INDIC
Locale
指定区域设置标识符。
lpLocaleString
一个指向字符串缓冲区的指针,其中包含以 Null 结尾的区域设置标识符字符串。请注意,lpLocaleString 应为 Unicode (W) 版本的 EnumLanguageGroupLocalesProc 的 LPWSTR,以及 ANSI (A) 版本的 EnumLanguageGroupLocalesProc 的 LPSTR。
lParam
指定传递给 EnumLanguageGroupLocales 函数的应用程序定义的参数。可在检查错误时使用此参数。
返回值
-
要继续枚举,回调函数应返回 TRUE。
-
要停止枚举,回调函数应返回 FALSE。
备注
-
EnumLanguageGroupLocalesProc 是应用程序定义的函数名称的占位符。
-
EnumLanguageGroupLocalesProc 函数可执行任何所需的任务。
-
应用程序通过将其地址传递给 EnumLanguageGroupLocales 函数来注册 EnumLanguageGroupLocalesProc 函数。
-
类型 LANGGROUPLOCALE_ENUMPROC 的值是一个指向 EnumLanguageGroupLocalesProc 函数的指针。