GetProcessPreferredUILanguages-Funktion (winnls.h)

Artikel
08/27/2023

Ruft die bevorzugten Benutzeroberflächensprachen des Prozesses ab. Weitere Informationen finden Sie unter Sprachverwaltung der Benutzeroberfläche.

Syntax

BOOL GetProcessPreferredUILanguages(
  [in]            DWORD   dwFlags,
  [out]           PULONG  pulNumLanguages,
  [out, optional] PZZWSTR pwszLanguagesBuffer,
  [in, out]       PULONG  pcchLanguagesBuffer
);

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.

Wert	Bedeutung
MUI_LANGUAGE_ID	Rufen Sie die Sprachzeichenfolgen im Sprachbezeichnerformat ab.
MUI_LANGUAGE_NAME	Rufen Sie die Sprachzeichenfolgen im Sprachnamenformat ab.

[out] pulNumLanguages

Zeiger auf die Anzahl der in pwszLanguagesBuffer abgerufenen Sprachen.

[out, optional] pwszLanguagesBuffer

Optional. Zeiger auf einen doppelten NULL-beendeten Puffer mit mehreren Zeichenfolgen, in dem die Funktion eine geordnete, nulltrennende Liste in der Voreinstellungsreihenfolge abruft, beginnend mit der am meisten bevorzugten.

Wenn dieser Parameter auf NULL und pcchLanguagesBuffer auf 0 festgelegt ist, ruft die Funktion die erforderliche Größe des Sprachpuffers in pcchLanguagesBuffer ab. Die erforderliche Größe enthält die beiden NULL-Zeichen.

[in, out] pcchLanguagesBuffer

Zeiger auf die Größe in Zeichen für den Sprachpuffer, der von pwszLanguagesBuffer angegeben wird. Bei erfolgreicher Rückgabe von der Funktion enthält der Parameter die Größe des abgerufenen Sprachpuffers.

Wenn dieser Parameter auf 0 und pwszLanguagesBuffer auf NULL festgelegt ist, ruft die Funktion die erforderliche Größe des Sprachpuffers in pcchLanguagesBuffer ab.

Rückgabewert

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

ERROR_INSUFFICIENT_BUFFER. Eine angegebene Puffergröße war nicht groß genug, oder sie wurde fälschlicherweise auf NULL festgelegt.
ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Wenn die Liste der bevorzugten Benutzeroberflächensprachen des Prozesses leer ist oder die für den Prozess angegebenen Sprachen ungültig sind, ist die Funktion erfolgreich und gibt einen leeren Multistring in pwszLanguagesBuffer und 2 im parameter pcchLanguagesBuffer zurück.

Hinweise

Abhängig von den von der Anwendung angegebenen Flags kann diese Funktion eine Liste abrufen, die aus den bevorzugten Benutzeroberflächensprachen des Prozesses besteht. Wenn eine doppelte Sprache auftritt, ruft die Funktion nur die erste instance der duplizierten Sprache ab.

Wenn MUI_LANGUAGE_ID angegeben wird, sind die abgerufenen Sprachzeichenfolgen hexadezimale Sprachbezeichner.

die nicht das führende 0x enthalten und 4 Zeichen lang sind. Beispielsweise wird en-US zurückgegeben.

als "0409" und en als "0009".

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 GetProcessPreferredUILanguages(
            System.UInt32 dwFlags,
            ref System.UInt32 pulNumLanguages,
            System.IntPtr pwszLanguagesBuffer,
            ref System.UInt32 pcchLanguagesBuffer
            );

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

Multilingual User Interface

Mehrsprachige Benutzeroberflächenfunktionen

SetProcessPreferredUILanguages

Share via