Função EnumSystemCodePagesA (winnls.h)

  • Artigo

Enumera as páginas de código instaladas ou compatíveis com um sistema operacional.

Sintaxe

BOOL EnumSystemCodePagesA(
  [in] CODEPAGE_ENUMPROCA lpCodePageEnumProc,
  [in] DWORD              dwFlags
);

Parâmetros

[in] lpCodePageEnumProc

Ponteiro para uma função de retorno de chamada definida pelo aplicativo. A função EnumSystemCodePages enumera páginas de código fazendo chamadas repetidas para essa função de retorno de chamada. Para obter mais informações, consulte EnumCodePagesProc.

[in] dwFlags

Sinalizador especificando as páginas de código a serem enumeradas. Esse parâmetro pode ter um dos seguintes valores, que são mutuamente exclusivos.

Valor Significado
CP_INSTALLED
 Enumerar somente páginas de código instaladas.
CP_SUPPORTED
 Enumerar todas as páginas de código com suporte.

Retornar valor

Retorna um valor diferente de zero se tiver êxito ou 0 de outra forma. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

  • ERROR_BADDB. A função não pôde acessar os dados. Normalmente, essa situação não deve ocorrer e normalmente indica uma instalação incorreta, um problema de disco ou similar.
  • ERROR_INVALID_FLAGS. Os valores fornecidos para sinalizadores não eram válidos.
  • ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Comentários

Essa função enumera as páginas de código passando identificadores de página de código, um de cada vez, para a função de retorno de chamada definida pelo aplicativo especificada. Esse processo continua até que todos os identificadores de página de código instalados ou com suporte tenham sido passados para a função de retorno de chamada ou a função de retorno de chamada retorne FALSE.

Quando um aplicativo está usando essa função para determinar uma página de código apropriada para salvar dados, ele deve usar Unicode quando possível. Outras páginas de código não são tão portáteis quanto Unicode entre fornecedores ou sistemas operacionais, devido a diferentes implementações dos padrões associados.

Observação

O cabeçalho winnls.h define EnumSystemCodePages como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winnls.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

EnumCodePagesProc

Suporte à linguagem nacional

Funções de suporte à linguagem nacional