Funzione SetProcessPreferredUILanguages (winnls.h)

Articolo
08/27/2023

Imposta le lingue dell'interfaccia utente preferite per il processo dell'applicazione. Per altre informazioni, vedere Gestione del linguaggio dell'interfaccia utente.

Sintassi

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

Parametri

[in] dwFlags

Flag che identificano il formato della lingua da usare per le lingue preferite dell'interfaccia utente del processo. I flag si escludono a vicenda e il valore predefinito è MUI_LANGUAGE_NAME.

È consigliabile usare MUI_LANGUAGE_NAME anziché MUI_LANGUAGE_ID.

Valore	Significato
MUI_LANGUAGE_ID	Le stringhe della lingua dei parametri di input sono in formato identificatore di lingua .
MUI_LANGUAGE_NAME	Le stringhe della lingua dei parametri di input sono in formato nome lingua .

[in, optional] pwszLanguagesBuffer

Puntatore a un buffer multistrido con terminazione Null doppia che contiene un elenco ordinato e delimitato da Null in ordine decrescente di preferenza. Se nel buffer sono presenti più di cinque lingue, la funzione imposta solo le prime cinque lingue valide.

In alternativa, questo parametro può contenere NULL se non è necessario alcun elenco di lingue. In questo caso, la funzione cancella le lingue dell'interfaccia utente preferite per il processo.

[out, optional] pulNumLanguages

Puntatore al numero di lingue impostate nell'elenco delle lingue del processo dal buffer di input, fino a un massimo di cinque.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario. Per ottenere informazioni sull'errore estese, l'applicazione può chiamare GetLastError, che può restituire il codice di errore seguente:

ERROR_INVALID_PARAMETER. Viene specificato un parametro non valido.

Se l'elenco delle lingue preferite dell'interfaccia utente del processo è vuoto o se le lingue specificate per il processo non sono valide, la funzione ha esito positivo e imposta 0 nel parametro pulNumLanguages .

Commenti

Idealmente, le applicazioni chiameranno SetProcessPreferredUILanguages appena possibile dopo l'avvio.

Al termine della restituzione di questa funzione, l'applicazione può chiamare GetProcessPreferredUILanguages per verificare ed esaminare l'elenco di lingue risultanti.

Quando si specifica MUI_LANGUAGE_ID, le stringhe della lingua dei parametri di input devono usare il linguaggio esadecimale

identificatori che non includono l'0x iniziale e sono di 4 caratteri. Ad esempio, en-US deve essere

passato come "0409" e en come "0009".

Nota L'uso di MUI_LANGUAGE_NAME è consigliato in MUI_LANGUAGE_ID.

Firma C#

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

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

GetProcessPreferredUILanguages

Interfaccia utente multilingue

Funzioni dell'interfaccia utente multilingue

Condividi tramite