Funzione EnumSystemLocalesEx (winnls.h)
Enumera le impostazioni locali installate in o supportate da un sistema operativo.
Sintassi
BOOL EnumSystemLocalesEx(
[in] LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
[in] DWORD dwFlags,
[in] LPARAM lParam,
[in, optional] LPVOID lpReserved
);
Parametri
[in] lpLocaleEnumProcEx
Puntatore a una funzione di callback definita dall'applicazione. La funzione EnumSystemLocalesEx enumera le impostazioni locali effettuando chiamate ripetute a questa funzione di callback. Per altre informazioni, vedere EnumLocalesProcEx.
[in] dwFlags
Flag che identificano le impostazioni locali da enumerare. I flag possono essere usati singly o combinati usando un OR binario. Se l'applicazione specifica 0 per questo parametro, la funzione si comporta come per LOCALE_ALL.
- LOCALE_ALL
- LOCALE_ALTERNATE_SORTS; vedere la sezione Osservazioni
- LOCALE_NEUTRALDATA
- LOCALE_SUPPLEMENTAL
- LOCALE_WINDOWS
[in] lParam
Parametro fornito dall'applicazione da passare alla funzione di callback. Ciò è particolarmente utile per le applicazioni multithreading.
[in, optional] lpReserved
Riservati; deve essere NULL.
Valore restituito
Restituisce un valore diverso da zero se ha esito positivo o 0 in caso contrario. Per ottenere informazioni estese sull'errore, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:
- ERROR_BADDB. La funzione non è riuscita ad accedere ai dati. Questa situazione non deve normalmente verificarsi e in genere indica un'installazione non valida, un problema del disco o un simile.
- 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 impostazioni locali passando i nomi delle impostazioni locali, uno alla volta, alla funzione di callback definita dall'applicazione specificata da lpLocaleEnumProcEx. L'enumerazione continua fino a quando non vengono passati tutti i nomi installati o supportati alla funzione di callback o la funzione di callback restituisce FALSE.
Le scelte per il parametro dwFlags sono diverse da quelle per EnumSystemLocales, che devono distinguere tra le impostazioni locali installate e supportate.
Se dwFlags specifica LOCALE_ALTERNATE_SORTS, la funzione di callback viene chiamata per ogni impostazione locale che rappresenta un ordinamento alternativo. Per impostazione predefinita, ad esempio, spagnolo (Spagna) è l'ordinamento internazionale, ma l'ordinamento tradizionale è disponibile per un ordinamento alternativo. Tedesco (Germania) usa l'ordinamento del dizionario, ma è disponibile un ordinamento alternativo della rubrica.
Esempio
Un esempio che mostra l'uso di questa funzione è disponibile in NLS: Esempio di API basate su nome.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | winnls.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |