Funzione EnumSystemCodePagesA (winnls.h)

Articolo
11/20/2024

Enumera le tabelle 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 tabelle codici effettuando chiamate ripetute a questa funzione di callback. Per altre informazioni, vedere EnumCodePagesProc.

[in] dwFlags

Flag che specifica le tabelle codici da enumerare. Questo parametro può avere uno dei valori seguenti, che si escludono a vicenda.

Valore	Significato
CP_INSTALLED	Enumerare solo le tabelle codici installate.
CP_SUPPORTED	Enumerare tutte le tabelle codici supportate.

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 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 le tabelle 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 tabelle codici non sono portabili 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 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 [app desktop \| App UWP]
server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	winnls.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

EnumCodePagesProc

supporto linguistico nazionale

funzioni di supporto del linguaggio nazionale

Condividi tramite