VerLanguageName

The VerLanguageName function converts the specified binary Microsoft language identifier into a text representation of the language.

Parameters

idLang

Specifies the binary Microsoft language identifier. For example, VerLanguageName translates 0x040A into Castilian Spanish. If VerLanguageName does not recognize the identifier, the lpszLang parameter will point to a default string (“Language Neutral”). For a complete list of the language identifiers supported by Win32, see the following Comments section.

lpszLang

Points to the buffer to receive the null-terminated string representing the language specified by the idLang parameter.

cbLang

Indicates the size of the buffer, in bytes, pointed to by lpszLang.

Return Value

The return value is the length of the string that represents the language identifier, if the function is successful. This value does not include the null character at the end of the string. If this value is greater than cbLang, the string was truncated to cbLang. The return value is zero if an error occurs. Unknown idLang values do not produce errors.

Comments

Typically, an installation application uses this function to translate a language identifier returned by the VerQueryValue function. The text string may be used in a dialog box that asks the user how to proceed in the event of a language conflict.

The following list shows the possible language identifier values: