Funzione EnumLanguageGroupLocalesA (winnls.h)

Articolo
08/27/2023

Enumera le impostazioni locali in un gruppo di linguaggio specificato.

Nota Per le 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 linguaggio per cui enumerare le impostazioni locali. Per il parametro è possibile specificare uno dei valori riportati di seguito:

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

Riservati; 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ò essere usato anche per garantire la sicurezza del thread nella funzione di callback.

Valore restituito

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

ERROR_BADDB. Impossibile accedere ai dati. Questa situazione non dovrebbe normalmente verificarsi e in genere indica un'installazione non valida, un problema del disco o il tipo.
ERROR_INVALID_FLAGS. I valori forniti per i flag non sono validi.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Commenti

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll