Funzione EnumLanguageGroupLocalesA (winnls.h)

Articolo
11/20/2024

Enumera le impostazioni locali in un gruppo di lingue specificato.

Nota Per impostazioni locali personalizzate, l'applicazione deve chiamare EnumSystemLocalesEx in preferenza per EnumLanguageGroupLocales.

Sintassi

BOOL EnumLanguageGroupLocalesA(
  [in] LANGGROUPLOCALE_ENUMPROCA lpLangGroupLocaleEnumProc,
  [in] LGRPID                    LanguageGroup,
  [in] DWORD                     dwFlags,
  [in] LONG_PTR                  lParam
);

Parametri

[in] lpLangGroupLocaleEnumProc

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

[in] LanguageGroup

Identificatore del gruppo di lingue per cui enumerare le impostazioni locali. Questo parametro può avere uno dei valori seguenti:

LGRPID_ARABIC
LGRPID_ARMENIAN
LGRPID_BALTIC
LGRPID_CENTRAL_EUROPE
LGRPID_CYRILLIC
LGRPID_GEORGIAN
LGRPID_GREEK
LGRPID_HEBREW
LGRPID_INDIC
LGRPID_JAPANESE
LGRPID_KOREAN
LGRPID_SIMPLIFIED_CHINESE
LGRPID_TRADITIONAL_CHINESE
LGRPID_THAI
LGRPID_TURKIC
LGRPID_TURKISH
LGRPID_VIETNAMESE
LGRPID_WESTERN_EUROPE

[in] dwFlags

Riservato; deve essere 0.

[in] lParam

Valore definito dall'applicazione da passare alla funzione di callback. Questo valore può essere usato per il controllo degli errori. Può anche essere usato per garantire la thread safety nella funzione di callback.

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

Questa funzione enumera le impostazioni locali nel gruppo di linguaggio specificato passando gli identificatori delle impostazioni locali, uno alla volta, alla funzione di callback definita dall'applicazione. Questo processo continua fino a quando EnumLanguageGroupLocales trova l'ultimo identificatore delle impostazioni locali o la funzione di callback restituisce FALSE.

Nota

L'intestazione winnls.h definisce EnumLanguageGroupLocales 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