Funzione EnumSystemLanguageGroupsA (winnls.h)

  • Articolo

Enumera i gruppi di lingue installati in o supportati da un sistema operativo.

Nota Per le impostazioni locali personalizzate, l'applicazione deve chiamare EnumSystemLocalesEx anziché EnumSystemLanguageGroups.

 

Sintassi

BOOL EnumSystemLanguageGroupsA(
  [in] LANGUAGEGROUP_ENUMPROCA lpLanguageGroupEnumProc,
  [in] DWORD                   dwFlags,
  [in] LONG_PTR                lParam
);

Parametri

[in] lpLanguageGroupEnumProc

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

[in] dwFlags

Flag che specificano gli identificatori del gruppo di linguaggio da enumerare. Questo parametro può avere uno dei valori seguenti.

Valore Significato
LGRPID_INSTALLED
 Enumerare solo gli identificatori del gruppo di linguaggio installati.
LGRPID_SUPPORTED
 Enumerare tutti gli identificatori del gruppo di linguaggio supportati.

[in] lParam

Valore definito dall'applicazione per passare alla funzione di callback. Questo parametro può essere usato nel controllo degli errori. Può essere usato anche per garantire la sicurezza del thread nella funzione di callback.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE 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 i gruppi di linguaggio passando gli identificatori del gruppo di linguaggio, uno alla volta, alla funzione di callback definita dall'applicazione specificata. Questo processo continua fino a quando non viene trovato l'ultimo identificatore del gruppo di linguaggio o la funzione di callback restituisce FALSE.

Nota

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

Requisito Valore
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

Vedere anche

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

Supporto per la lingua nazionale

Funzioni di supporto del linguaggio nazionale