Estructura CPINFOEXA (winnls.h)
Contiene información sobre una página de códigos. Esta estructura la usa la función
Sintaxis
typedef struct _cpinfoexA {
UINT MaxCharSize;
BYTE DefaultChar[MAX_DEFAULTCHAR];
BYTE LeadByte[MAX_LEADBYTES];
WCHAR UnicodeDefaultChar;
UINT CodePage;
CHAR CodePageName[MAX_PATH];
} CPINFOEXA, *LPCPINFOEXA;
Miembros
MaxCharSize
Longitud máxima, en bytes, de un carácter en la página de códigos. La longitud puede ser 1 para un juego de caracteres de un solo byte (SBCS), 2 para un juego de caracteres de doble byte (DBCS) o un valor mayor que 2 para otros tipos de juego de caracteres. La función no puede usar el tamaño para distinguir un SBCS o un DBCS de otros juegos de caracteres debido a otros factores, por ejemplo, el uso de páginas de códigos ISCII o ISO-2022-xx.
DefaultChar[MAX_DEFAULTCHAR]
Carácter predeterminado que se usa al traducir cadenas de caracteres a la página de códigos específica. El WideCharToMultiByte usa este carácter función si no se especifica un carácter predeterminado explícito. El valor predeterminado suele ser el carácter "?" de la página de códigos.
LeadByte[MAX_LEADBYTES]
Matriz de longitud fija de intervalos de bytes de plomo, para la que el número de intervalos de bytes de cliente potencial es variable. Si la página de códigos no tiene bytes de cliente potencial, todos los elementos de la matriz se establecen en NULL. Si la página de códigos tiene bytes de cliente potencial, la matriz especifica un valor inicial y un valor final para cada intervalo. Los intervalos son inclusivos y el número máximo de intervalos para cualquier página de códigos es cinco. La matriz usa dos bytes para describir cada intervalo, con dos bytes NULL como terminador después del último intervalo.
UnicodeDefaultChar
Carácter predeterminado Unicode usado en traducciones de la página de códigos específica. El valor predeterminado suele ser el carácter "?" o el carácter de punto intermedio katakana. El carácter predeterminado Unicode lo usa la función
CodePage
Valor de página de códigos. Este valor refleja la página de códigos pasada a la función
CodePageName[MAX_PATH]
Nombre completo de la página de códigos. Tenga en cuenta que este nombre está localizado y no se garantiza la unicidad ni la coherencia entre las versiones del sistema operativo o los equipos.
Observaciones
Los bytes de cliente potencial son únicos para páginas de códigos DBCS que permiten más de 256 caracteres. Un byte principal es el primer byte de un carácter de 2 bytes en un DBCS. En cada página de códigos dbCS, los bytes de cliente potencial ocupan un intervalo específico de valores de bytes. Este intervalo es diferente para diferentes páginas de códigos.
La información de bytes de cliente potencial no es muy útil para la mayoría de las páginas de códigos y ni siquiera se proporciona para muchas codificaciones de varios bytes, por ejemplo, UTF-8 y GB18030. No se recomienda que las aplicaciones usen esta información para predecir lo que hará la función multibyteToWideChar de
Nota
El encabezado winnls.h define CPINFOEX como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| servidor mínimo admitido | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| encabezado de |
winnls.h (incluya Windows.h) |