Función RtlUpcaseUnicodeStringToOemString (ntifs.h)

Artículo
08/07/2023

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

Sintaxis

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToOemString(
       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 del OEM. Si AllocateDestinationString es TRUE, RtlUpcaseUnicodeStringToOemString asigna un búfer lo suficientemente grande como para contener la cadena, pasa un puntero a ella 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 RtlUpcaseUnicodeStringToOemString 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 llamando a RtlFreeOemString.

Valor devuelto

RtlUpcaseUnicodeStringToOemString devuelve STATUS_SUCCESS si se traduce la cadena en DestinationString . De lo contrario, no se asignó ningún almacenamiento ni se realizó ninguna conversión.

Comentarios

RtlUpcaseUnicodeStringToOemString traduce la cadena de origen dada mediante la página de códigos OEM que se instaló como la página de códigos del sistema actual en tiempo de arranque del sistema y convierte la cadena oem en mayúsculas.

Esta rutina puede sustituir un carácter predeterminado en la cadena de destino por todos los caracteres de cadena de origen que no se pueden asignar a la página de códigos actual y, a continuación, devolver STATUS_SUCCESS.

Esta rutina no modifica la cadena de origen. Devuelve una cadena OEM terminada en null.

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