Función IsDBCSLeadByte (winnls.h)

  • Artículo

Determina si un carácter especificado es un byte principal para la página de códigos ANSI de Windows predeterminada del sistema (CP_ACP). Un byte principal es el primer byte de un carácter de dos bytes en un juego de caracteres de doble byte (DBCS) para la página de códigos.

Nota Para usar otra página de códigos, la aplicación debe usar la función IsDBCSLeadByteEx .
 

Sintaxis

BOOL IsDBCSLeadByte(
  [in] BYTE TestChar
);

Parámetros

[in] TestChar

Carácter que se va a probar.

Valor devuelto

Devuelve un valor distinto de cero si el carácter de prueba es potencialmente un byte potencial. La función devuelve 0 si el carácter de prueba no es un byte principal o si es un carácter de un solo byte. Para obtener información de error extendida, la aplicación puede llamar a GetLastError.

Comentarios

Nota Esta función no valida la presencia o validez de un byte final. Por lo tanto, MultiByteToWideChar podría no reconocer una secuencia que la aplicación que usa IsDBCSLeadByte notifica como un byte potencial. La aplicación puede desincronizarse fácilmente con los resultados de MultiByteToWideChar, lo que podría provocar errores inesperados o errores de coincidencia de tamaño de búfer.
 
En general, en lugar de intentar la manipulación de bajo nivel de datos de página de códigos, las aplicaciones deben usar MultiByteToWideChar para convertir los datos en UTF-16 y trabajar con ellos en esa codificación.

Los valores de bytes de cliente potencial son específicos de cada DBCS distinto. Algunos valores de bytes pueden aparecer en una sola página de códigos como byte inicial y final de un carácter DBCS.

Para tener sentido una cadena DBCS, una aplicación se inicia normalmente al principio de una cadena y examina hacia delante, realizando un seguimiento cuando encuentra un byte principal y tratando el siguiente byte como la parte final del mismo carácter. Si la aplicación debe realizar una copia de seguridad, debe usar CharPrev en lugar de intentar desarrollar su propio algoritmo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winnls.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

IsDBCSLeadByteEx

MultiByteToWideChar

Funciones Unicode y Juego de caracteres

Conjuntos de caracteres y Unicode