Funzione EnumSystemLocalesA (winnls.h)

Articolo
11/20/2024

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

Nota Per motivi di interoperabilità, l'applicazione deve preferire la funzione EnumSystemLocalesEx a EnumSystemLocales perché Microsoft sta eseguendo la migrazione verso l'uso dei nomi delle impostazioni locali anziché degli identificatori delle impostazioni locali per le nuove impostazioni locali. Qualsiasi applicazione che verrà eseguita solo in Windows Vista e versioni successive deve usare EnumSystemLocalesEx.

Sintassi

BOOL EnumSystemLocalesA(
  [in] LOCALE_ENUMPROCA lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

Parametri

[in] lpLocaleEnumProc

Puntatore a una funzione di callback definita dall'applicazione. Per altre informazioni, vedere EnumLocalesProc.

[in] dwFlags

Flag che specificano gli identificatori delle impostazioni locali da enumerare. I flag possono essere usati in modo singly o combinato usando un OR binario. Se l'applicazione specifica 0 per questo parametro, la funzione si comporta come per LCID_SUPPORTED.

Valore	Significato
LCID_INSTALLED	Enumerare solo gli identificatori delle impostazioni locali installate. Questo valore non può essere utilizzato con LCID_SUPPORTED.
LCID_SUPPORTED	Enumerare tutti gli identificatori delle impostazioni locali supportati. Questo valore non può essere utilizzato con LCID_INSTALLED.
LCID_ALTERNATE_SORTS	Enumerare solo gli identificatori delle impostazioni locali di ordinamento alternativi. Se questo valore viene usato con LCID_INSTALLED o LCID_SUPPORTED, vengono recuperate le impostazioni locali installate o supportate, nonché gli identificatori delle impostazioni locali di ordinamento alternativi.

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 dovrebbe verificarsi normalmente e in genere indica un'installazione non valida, un problema del disco o simili.
ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Osservazioni

La funzione enumera le impostazioni locali passando gli identificatori delle impostazioni locali, uno alla volta, alla funzione di callback definita dall'applicazione specificata. Questa operazione continua fino a quando tutti gli identificatori delle impostazioni locali installati o supportati non vengono passati alla funzione di callback o la funzione di callback restituisce FALSE.

Nota

L'intestazione winnls.h definisce EnumSystemLocales 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winnls.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

EnumLocalesProc

EnumSystemLocalesEx

supporto linguistico nazionale

funzioni di supporto del linguaggio nazionale

Condividi tramite