Funzione GetProcessPreferredUILanguages (winnls.h)

Articolo
03/08/2023

Recupera le lingue preferite dell'interfaccia utente preferite. Per altre informazioni, vedere Gestione linguaggio interfaccia utente.

Sintassi

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

Parametri

[in] dwFlags

Contrassegni che identificano il formato della lingua da usare per le lingue preferite dell'interfaccia utente. I flag sono reciprocamente esclusivi e il valore predefinito è MUI_LANGUAGE_NAME.

Valore	Significato
MUI_LANGUAGE_ID	Recuperare le stringhe della lingua nel formato dell'identificatore della lingua .
MUI_LANGUAGE_NAME	Recuperare le stringhe di lingua nel formato del nome della lingua .

[out] pulNumLanguages

Puntatore al numero di lingue recuperate in pwszLanguagesBuffer.

[out, optional] pwszLanguagesBuffer

facoltativo. Puntatore a un buffer multi-stringa con terminazione null doppia in cui la funzione recupera un elenco ordinato e delimitato da null nell'ordine di preferenza, a partire dal più preferibile.

In alternativa, se questo parametro è impostato su NULL e pcchLanguagesBuffer è impostato su 0, la funzione recupera le dimensioni necessarie del buffer del linguaggio in pcchLanguagesBuffer. Le dimensioni necessarie includono i due caratteri Null.

[in, out] pcchLanguagesBuffer

Puntatore alle dimensioni, in caratteri, per il buffer della lingua indicato da pwszLanguagesBuffer. Al termine della restituzione dalla funzione, il parametro contiene le dimensioni del buffer del linguaggio recuperato.

In alternativa, se questo parametro è impostato su 0 e pwszLanguagesBuffer è impostato su NULL, la funzione recupera le dimensioni necessarie del buffer del linguaggio in pcchLanguagesBuffer.

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 uno dei codici di errore seguenti:

ERROR_INSUFFICIENT_BUFFER. Una dimensione del buffer fornita non è stata sufficiente oppure è stata impostata in modo errato su NULL.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Se l'elenco delle lingue preferite dell'interfaccia utente è vuoto o se le lingue specificate per il processo non sono valide, la funzione riesce e restituisce un multistringa vuoto in pwszLanguagesBuffer e 2 nel parametro pcchLanguagesBuffer .

Commenti

A seconda dei flag specificati dall'applicazione, questa funzione può recuperare un elenco costituito dalle lingue dell'interfaccia utente preferite del processo. Se rileva una lingua duplicata, la funzione recupera solo la prima istanza del linguaggio duplicato.

Quando viene specificato MUI_LANGUAGE_ID, le stringhe di lingua recuperate saranno identificatori di lingua esadecimali

che non includono l'0x iniziale e sarà di 4 caratteri in lunghezza. Ad esempio, en-US verrà restituito

come "0409" e en come "0009".

Nota L'uso di MUI_LANGUAGE_NAME è consigliato per MUI_LANGUAGE_ID.

Firma C#

[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
            );

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 (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Interfaccia utente multilingue

Funzioni dell'interfaccia utente multilingue

SetProcessPreferredUILanguages

Condividi tramite