Funzione EnumSystemLocalesW (winnls.h)
Enumera le impostazioni locali installate in o supportate da un sistema operativo.
Sintassi
BOOL EnumSystemLocalesW(
[in] LOCALE_ENUMPROCW 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 singly o combinati usando un OR binario. Se l'applicazione specifica 0 per questo parametro, la funzione si comporta come per LCID_SUPPORTED.
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 deve normalmente verificarsi e in genere indica un'installazione non valida, un problema del disco o un simile.
- ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
- ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.
Commenti
La funzione enumera le impostazioni locali passando identificatori delle impostazioni locali, uno alla volta, alla funzione di callback definita dall'applicazione specificata. Ciò 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 (include Windows.h) |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |