Função EnumSystemCodePagesA (winnls.h)
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 |
|---|---|
|
Enumerar somente páginas de código instaladas. |
|
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 |