SetProcessPreferredUILanguages-Funktion (winnls.h)

Artikel
08/27/2023

Legt die bevorzugten Benutzeroberflächensprachen des Prozesses für den Anwendungsprozess fest. Weitere Informationen finden Sie unter Sprachverwaltung der Benutzeroberfläche.

Syntax

BOOL SetProcessPreferredUILanguages(
  [in]            DWORD    dwFlags,
  [in, optional]  PCZZWSTR pwszLanguagesBuffer,
  [out, optional] PULONG   pulNumLanguages
);

Parameter

[in] dwFlags

Flags, die das Sprachformat identifizieren, das für die bevorzugten Benutzeroberflächensprachen des Prozesses verwendet werden soll. Die Flags schließen sich gegenseitig aus, und der Standardwert ist MUI_LANGUAGE_NAME.

Es wird empfohlen, MUI_LANGUAGE_NAME anstelle von MUI_LANGUAGE_ID zu verwenden.

Wert	Bedeutung
MUI_LANGUAGE_ID	Die Sprachzeichenfolgen für eingabeparameter befinden sich im Sprachbezeichnerformat .
MUI_LANGUAGE_NAME	Die Sprachzeichenfolgen der Eingabeparameter befinden sich im Format des Sprachnamens .

[in, optional] pwszLanguagesBuffer

Zeiger auf einen doppelten NULL-beendeten Puffer mit mehreren Zeichenfolgen, der eine sortierte Liste mit NULL-Trennzeichen in abnehmender Reihenfolge der Einstellung enthält. Wenn mehr als fünf Sprachen im Puffer vorhanden sind, legt die Funktion nur die ersten fünf gültigen Sprachen fest.

Alternativ kann dieser Parameter NULL enthalten, wenn keine Sprachliste erforderlich ist. In diesem Fall löscht die Funktion die bevorzugten Benutzeroberflächensprachen für den Prozess.

[out, optional] pulNumLanguages

Zeiger auf die Anzahl der Sprachen, die in der Liste der Prozesssprachen aus dem Eingabepuffer festgelegt wurden, bis zu maximal fünf.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError aufrufen, wodurch der folgende Fehlercode zurückgegeben werden kann:

ERROR_INVALID_PARAMETER. Ein ungültiger Parameter wird angegeben.

Wenn die Liste der bevorzugten Benutzeroberflächensprachen für den Prozess leer ist oder die für den Prozess angegebenen Sprachen ungültig sind, ist die Funktion erfolgreich und legt 0 im Parameter pulNumLanguages fest.

Hinweise

Im Idealfall rufen Anwendungen SetProcessPreferredUILanguages so schnell wie möglich nach dem Start auf.

Nachdem diese Funktion zurückgegeben wurde, kann die Anwendung GetProcessPreferredUILanguages aufrufen, um die resultierende Sprachliste zu überprüfen und zu untersuchen.

Wenn MUI_LANGUAGE_ID angegeben wird, müssen die Sprachzeichenfolgen des Eingabeparameters hexadezimale Sprache verwenden.

Bezeichner, die nicht das führende 0x enthalten und 4 Zeichen lang sind. en-US sollte z. B.

wurde als "0409" und en als "0009" übergeben.

Hinweis Die Verwendung von MUI_LANGUAGE_NAME wird über MUI_LANGUAGE_ID empfohlen.

C#-Signatur

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

GetProcessPreferredUILanguages

Multilingual User Interface

Mehrsprachige Benutzeroberflächenfunktionen