Função GetCPInfoExA (winnls.h)

Artigo
11/20/2024

Recupera informações sobre qualquer página de código instalada ou disponível válida.

Sintaxe

BOOL GetCPInfoExA(
  [in]  UINT        CodePage,
  [in]  DWORD       dwFlags,
  [out] LPCPINFOEXA lpCPInfoEx
);

Parâmetros

[in] CodePage

Identificador para a página de código para a qual recuperar informações. O aplicativo pode especificar o identificador de página de código para qualquer página de código instalada ou disponível ou um dos seguintes valores predefinidos. Consulte identificadores de página de código para obter uma lista de identificadores para ANSI e outras páginas de código.

Valor	Significado
CP_ACP	Use a página de código ANSI do Windows padrão do sistema.
CP_MACCP	Use a página de código do Macintosh padrão do sistema.
CP_OEMCP	Use a página de código OEM padrão do sistema.
CP_THREAD_ACP	Use a página de código ANSI do thread atual.

[in] dwFlags

Reservado; deve ser 0.

[out] lpCPInfoEx

Ponteiro para uma estrutura de CPINFOEX que recebe informações sobre a página de código.

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_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Observações

As informações recuperadas na estrutura de CPINFOEX nem sempre são úteis para todas as páginas de código. Para determinar tamanhos de buffer, por exemplo, o aplicativo deve chamar MultiByteToWideChar ou WideCharToMultiByte para solicitar um tamanho de buffer preciso. Se configurações de CPINFOEX indicarem que existe um byte de lead, a função de conversão não necessariamente manipula bytes de chumbo de forma diferente, por exemplo, no caso de um byte de trilha ausente ou ilegal.

Nota

O cabeçalho winnls.h define GetCPInfoEx 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. 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

Consulte também

CPINFOEX

getacp

GetCPInfo

GetOEMCP

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional

Compartilhar via