Funzione EnumSystemLanguageGroupsW (winnls.h)

Articolo
11/20/2024

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 EnumSystemLanguageGroupsW(
  [in] LANGUAGEGROUP_ENUMPROCW 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 da passare alla funzione di callback. Questo parametro può essere usato nel controllo degli errori. Può anche essere usato per garantire la thread safety nella funzione di callback.

Valore restituito

Restituisce TRUE se ha esito positivo o false 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 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 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

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

supporto linguistico nazionale

funzioni di supporto del linguaggio nazionale

Condividi tramite