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
Sinalizar 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 as páginas de código instaladas. |
|
Enumerar todas as páginas de código com suporte. |
Valor de retorno
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. Essa situação normalmente 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.
Observações
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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winnls.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |