Funzione EnumSystemCodePagesA (winnls.h)

  • Articolo

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
CP_INSTALLED
 Enumerare solo le code pages installate.
CP_SUPPORTED
 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

Vedere anche

EnumCodePagesProc

Supporto per la lingua nazionale

Funzioni di supporto del linguaggio nazionale