Función RtlUpcaseUnicodeStringToCountedOemString (ntifs.h)

Artículo
02/26/2024

La rutina RtlUpcaseUnicodeStringToCountedOemString traduce una cadena de origen Unicode determinada en una cadena OEM con recuento en mayúsculas mediante la página de códigos oem del sistema actual.

Sintaxis

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToCountedOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parámetros

DestinationString

Puntero a un búfer asignado por el autor de la llamada para recibir la cadena de OEM con recuento. Si AllocateDestinationString es FALSE, el autor de la llamada también debe asignar un búfer para que el miembro buffer de DestinationString contenga los datos de OEM. Si AllocateDestinationString es TRUE, RtlUpcaseUnicodeStringToCountedOemString asigna un búfer lo suficientemente grande como para contener la cadena, le pasa un puntero en buffer y actualiza la longitud y los miembros de longitud máxima de DestinationString en consecuencia.

[in] SourceString

Puntero a la cadena Unicode que se va a traducir.

[in] AllocateDestinationString

Se establece en TRUE si RtlUpcaseUnicodeStringToCountedOemString debe asignar el espacio de búfer para DestinationString; en caso contrario, FALSE. Si este parámetro es TRUE, el autor de la llamada es responsable de liberar el búfer cuando ya no es necesario mediante una llamada a RtlFreeOemString.

Valor devuelto

RtlUpcaseUnicodeStringToCountedOemString devuelve STATUS_SUCCESS si devuelve una cadena traducida en DestinationString. De lo contrario, no se asignó ningún almacenamiento ni se realizó ninguna conversión. Devuelve STATUS_UNMAPPABLE_CHARACTER si no puede traducir un carácter en sourceString determinado.

Comentarios

RtlUpcaseUnicodeStringToCountedOemString devuelve una cadena que no está terminada en null. Traduce la cadena de origen dada mediante la página de códigos OEM que se instaló como página de códigos del sistema actual en tiempo de arranque del sistema y convierte la cadena traducida en mayúsculas.

Para buscar una asignación de mejor coincidencia para cualquier carácter especial, como un carácter de copyright, en la cadena de origen especificada, RtlUpcaseUnicodeStringToCountedOemString realiza las siguientes operaciones:

Traduce una copia de la cadena Unicode en SourceString en una cadena OEM.
Convierte la cadena OEM de nuevo en Unicode.
Convierte esta nueva cadena Unicode en mayúsculas.
Convierte la cadena Unicode mayúscula en una cadena OEM con recuento y la devuelve en DestinationString.

Esta rutina no modifica la cadena de origen.

Para obtener información sobre otras rutinas de control de cadenas, vea Rutinas de la biblioteca en tiempo de ejecución (RTL).