Estrutura CPINFOEXW (winnls.h)
Contém informações sobre uma página de código. Essa estrutura é usada pela função GetCPInfoEx
Sintaxe
typedef struct _cpinfoexW {
UINT MaxCharSize;
BYTE DefaultChar[MAX_DEFAULTCHAR];
BYTE LeadByte[MAX_LEADBYTES];
WCHAR UnicodeDefaultChar;
UINT CodePage;
WCHAR CodePageName[MAX_PATH];
} CPINFOEXW, *LPCPINFOEXW;
Membros
MaxCharSize
Comprimento máximo, em bytes, de um caractere na página de código. O comprimento pode ser 1 para um conjunto de caracteres de único byte (SBCS), 2 para um conjunto de caracteres de dois bytes (DBCS) ou um valor maior que 2 para outros tipos de conjunto de caracteres. A função não pode usar o tamanho para distinguir um SBCS ou um DBCS de outros conjuntos de caracteres devido a outros fatores, por exemplo, o uso de páginas de código ISCII ou ISO-2022-xx.
DefaultChar[MAX_DEFAULTCHAR]
Caractere padrão usado ao traduzir cadeias de caracteres para a página de código específica. Esse caractere será usado pela função
LeadByte[MAX_LEADBYTES]
Uma matriz de comprimento fixo de intervalos de bytes de chumbo, para os quais o número de intervalos de bytes de chumbo é variável. Se a página de código não tiver bytes potenciais, cada elemento da matriz será definido como NULL. Se a página de código tiver bytes potenciais, a matriz especificará um valor inicial e um valor final para cada intervalo. Os intervalos são inclusivos e o número máximo de intervalos para qualquer página de código é cinco. A matriz usa dois bytes para descrever cada intervalo, com dois bytes nulos como terminador após o último intervalo.
UnicodeDefaultChar
Caractere padrão Unicode usado em traduções da página de código específica. O padrão geralmente é o caractere "?" ou o caractere de ponto médio katakana. O caractere padrão Unicode é usado pela função
CodePage
Valor da página de código. Esse valor reflete a página de código passada para a função GetCPInfoEx. Consulte identificadores de página de código para obter uma lista de ANSI e outras páginas de código.
CodePageName[MAX_PATH]
Nome completo da página de código. Observe que esse nome é localizado e não é garantido para exclusividade ou consistência entre versões do sistema operacional ou computadores.
Observações
Os bytes potenciais são exclusivos para páginas de código DBCS que permitem mais de 256 caracteres. Um byte principal é o primeiro byte de um caractere de 2 bytes em um DBCS. Em cada página de código DBCS, os bytes potenciais ocupam um intervalo específico de valores de bytes. Esse intervalo é diferente para páginas de código diferentes.
As informações de bytes potenciais não são muito úteis para a maioria das páginas de código e nem são fornecidas para muitas codificações de vários bytes, por exemplo, UTF-8 e GB18030. Seus aplicativos são desencorajados a usar essas informações para prever o que a função
Nota
O cabeçalho winnls.h define CPINFOEX 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] |
cabeçalho | winnls.h (inclua Windows.h) |