Funzione EnumUILanguagesA (winnls.h)

Articolo
03/04/2024

Enumera le lingue dell'interfaccia utente disponibili nel sistema operativo e chiama la funzione di callback con ogni lingua nell'elenco.

Sintassi

BOOL EnumUILanguagesA(
  [in] UILANGUAGE_ENUMPROCA lpUILanguageEnumProc,
  [in] DWORD                dwFlags,
  [in] LONG_PTR             lParam
);

Parametri

[in] lpUILanguageEnumProc

Puntatore a una funzione di callback EnumUILanguagesProc definita dall'applicazione. EnumUILanguages chiama ripetutamente questa funzione per enumerare le lingue nell'elenco.

[in] dwFlags

Flag che identificano il formato e il filtro della lingua. I flag seguenti specificano il formato della lingua da passare alla funzione di callback. I flag di formato si escludono a vicenda e MUI_LANGUAGE_ID è l'impostazione predefinita.

Valore	Significato
MUI_LANGUAGE_ID	Passare l'identificatore di lingua nella stringa di lingua alla funzione di callback.
MUI_LANGUAGE_NAME	Passare il nome della lingua nella stringa di lingua alla funzione di callback.

I flag seguenti specificano il filtro per la funzione da usare nell'enumerazione dei linguaggi. I flag di filtro si escludono a vicenda e il valore predefinito è MUI_LICENSED_LANGUAGES.

Valore	Significato
MUI_ALL_INSTALLED_LANGUAGES	Enumerare tutte le lingue installate disponibili per il sistema operativo.
MUI_LICENSED_LANGUAGES	Enumerare tutte le lingue installate disponibili e concesse in licenza per l'uso.
MUI_GROUP_POLICY	Enumerare tutte le lingue installate disponibili e con licenza e consentite da Criteri di gruppo.

Windows Vista e versioni successive: L'applicazione può impostare dwFlags su 0 o su uno o più flag specificati. Un'impostazione pari a 0 fa sì che il valore predefinito del parametro sia MUI_LANGUAGE_ID | MUI_LICENSED_LANGUAGES.

Windows 2000, Windows XP, Windows Server 2003: L'applicazione deve impostare dwFlags su 0.

[in] lParam

Valore definito dall'applicazione.

Valore restituito

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

ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Commenti

Questa funzione enumera le lingue dell'interfaccia utente disponibili e, a seconda del flag specificato, concesso in licenza per l'uso nel sistema operativo. Passa identificatori di lingua o nomi di lingua, uno alla volta, alla funzione di callback EnumUILanguagesProc . La funzione EnumUILanguages continua a passare identificatori di lingua o nomi alla funzione di callback fino a quando non viene trovato l'ultimo linguaggio o la funzione di callback restituisce FALSE.

Per le applicazioni eseguite solo in Windows Vista e versioni successive, è consigliabile MUI_LANGUAGE_NAME su MUI_LANGUAGE_ID. MUI_LANGUAGE_NAME consente la differenziazione tra le lingue associate a impostazioni locali supplementari.

Se il flag MUI_LANGUAGE_ID viene specificato nella chiamata a questa funzione, le stringhe passate al callback

la funzione sarà identificatori di lingua esadecimali che non includono l'0x iniziale e sarà 4

caratteri di lunghezza. Ad esempio, en-US verrà passato come "0409" e en come "0009". Il valore "1000" viene passato alla funzione di callback per qualsiasi lingua associata a impostazioni locali supplementari. Questo valore corrisponde al valore esadecimale di LOCALE_CUSTOM_UNSPECIFIED. Non distingue tra le impostazioni locali supplementari, anche se la lingua selezionata è nell'elenco delle lingue dell'interfaccia utente preferite dall'utente o nell'elenco delle lingue dell'interfaccia utente preferite dal sistema.

Firma C#

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean EnumUILanguages(
            EnumUILanguagesProc lpUILanguageEnumProc,
            System.UInt32 dwFlags,
            System.IntPtr lParam
            );

Nota

L'intestazione winnls.h definisce EnumUILanguages come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll