Funzione EnumSystemCodePagesA (winnls.h)
Enumera le pagine codici installate in o supportate da un sistema operativo.
Sintassi
BOOL EnumSystemCodePagesA(
[in] CODEPAGE_ENUMPROCA lpCodePageEnumProc,
[in] DWORD dwFlags
);
Parametri
[in] lpCodePageEnumProc
Puntatore a una funzione di callback definita dall'applicazione. La funzione EnumSystemCodePages enumera le pagine codici eseguendo chiamate ripetute a questa funzione di callback. Per altre informazioni, vedere EnumCodePagesProc.
[in] dwFlags
Contrassegno che specifica le pagine codici da enumerare. Questo parametro può avere uno dei valori seguenti, che si escludono a vicenda.
| Valore | Significato |
|---|---|
|
Enumerare solo le code pages installate. |
|
Enumerare tutte le pagine codici supportate. |
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 pagine codici passando gli identificatori della tabella codici, uno alla volta, alla funzione di callback definita dall'applicazione specificata. Questo processo continua fino a quando non vengono passati tutti gli identificatori della tabella codici installati o supportati alla funzione di callback oppure la funzione di callback restituisce FALSE.
Quando un'applicazione usa questa funzione per determinare una tabella codici appropriata per il salvataggio dei dati, deve usare Unicode quando possibile. Altre pagine di codice non sono portatili come Unicode tra fornitori o sistemi operativi, a causa di implementazioni diverse degli standard associati.
Nota
L'intestazione winnls.h definisce EnumSystemCodePages 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 [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | winnls.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |