SetProcessPreferredUILanguages function

Sets the process preferred UI languages for the application process. For more information, see User Interface Language Management.

Syntax

BOOL SetProcessPreferredUILanguages(
  DWORD    dwFlags,
  PCZZWSTR pwszLanguagesBuffer,
  PULONG   pulNumLanguages
);

Parameters

dwFlags

Flags identifying the language format to use for the process preferred UI languages. The flags are mutually exclusive, and the default is MUI_LANGUAGE_NAME.

We recommend that you use MUI_LANGUAGE_NAME instead of MUI_LANGUAGE_ID.

Value Meaning
MUI_LANGUAGE_ID
The input parameter language strings are in language identifier format.
MUI_LANGUAGE_NAME
The input parameter language strings are in language name format.

pwszLanguagesBuffer

Pointer to a double null-terminated multi-string buffer that contains an ordered, null-delimited list in decreasing order of preference. If there are more than five languages in the buffer, the function only sets the first five valid languages.

Alternatively, this parameter can contain NULL if no language list is required. In this case, the function clears the preferred UI languages for the process.

pulNumLanguages

Pointer to the number of languages that has been set in the process language list from the input buffer, up to a maximum of five.

Return Value

Returns TRUE if successful or FALSE otherwise. To get extended error information, the application can call GetLastError, which can return the following error code:

  • ERROR_INVALID_PARAMETER. An invalid parameter is specified.
If the process preferred UI languages list is empty or if the languages specified for the process are not valid, the function succeeds and sets 0 in the pulNumLanguages parameter.

Remarks

Ideally, applications will call SetProcessPreferredUILanguages as soon as possible after launching.

After this function returns, the application can call GetProcessPreferredUILanguages to verify and examine the resulting language list.

When MUI_LANGUAGE_ID is specified, the input parameter language strings must use hexadecimal language

identifiers that do not include the leading 0x, and are 4 characters in length. For example, en-US should be

passed as "0409" and en as "0009".

Note  Use of MUI_LANGUAGE_NAME is recommended over MUI_LANGUAGE_ID.
 

C# Signature

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean SetProcessPreferredUILanguages(
            System.UInt32 dwFlags,
            System.String pwszLanguagesBuffer,
            ref System.UInt32 pulNumLanguages
            );

Requirements

   
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header winnls.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

GetProcessPreferredUILanguages

Multilingual User Interface

Multilingual User Interface Functions