Funzione EnumSystemLocalesEx (winnls.h)

  • Articolo

Enumera le impostazioni locali installate in o supportate da un sistema operativo.

Nota L'applicazione deve chiamare questa funzione in preferenza a EnumSystemLocales se progettata per l'esecuzione solo in Windows Vista e versioni successive.
 

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.

[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

Vedere anche

EnumLocalesProcEx

EnumSystemLocales

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale