winuser.h


CharUpper

La función CharUpper convierte una cadena de caracteres o un único carácter a mayúsculas. Si el operando es una cadena de caracteres, la función convierte los caracteres en el mismo lugar. Esta función sustituye a la función AnsiUpper.

Sintaxis

LPTSTR CharUpper(
    LPTSTR lpsz  // carácter o puntero a cadena
   );

Parámetros

lpsz: puntero a cadena terminada en null o especificación de un único carácter. Si la palabra de mayor peso de este parámetro es cero, la palabra de menor peso debe contener un único carácter a convertir.

Valor de retorno

Si el operando es una cadena de caracteres, la función devuelte un puntero a la cadena convertida. Ya que la cadena se convierte en el mismo lugar, el valor de retorno es lpsz.

Si el operando es un único carácter, el valor de retorno es un valor de 32 bits cuya palabra de mayor peso es cero y la de menor peso contiene el carácter convertido.

No hay notificación de éxito o fracaso. El fallo es raro.

Observaciones

Windows NT: para hacer la conversión, la función usa el manejador de lenguaje para el lenguaje actualmente seleccionado por el usuario durante la instalación o mediante el Panel de Control. Si no se ha seleccionado lenguaje, Windows realiza la conversión usando el mapeo interno por defecto. La conversión se hace basándose en el código de página asociado con la localización del proceso.

Windows 95: la función realiza la conversión barándose en la información asociada con la localización por defecot del usuario, que es la localización seleccionada por el usuario durante la instalación o usando el Panel de Control. Windows 95 no tiene manejadores de lenguaje.