Función RtlOemStringToUnicodeString (ntifs.h)

Artículo
02/26/2024

La rutina RtlOemStringToUnicodeString convierte una cadena de origen determinada en una cadena Unicode terminada en null mediante la página de códigos OEM del sistema actual.

Sintaxis

NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
       PUNICODE_STRING DestinationString,
  [in] PCOEM_STRING    SourceString,
  [in] BOOLEAN         AllocateDestinationString
);

Parámetros

DestinationString

Puntero a un búfer asignado por el autor de la llamada para recibir la cadena traducida. Si AllocateDestinationString es FALSE, el autor de la llamada también debe asignar un búfer para que el miembro Buffer de DestinationString contenga la cadena Unicode terminada en null. Si AllocateDestinationString es TRUE, RtlOemStringToUnicodeString asigna un búfer lo suficientemente grande como para contener la cadena, pasa un puntero a él en Buffer y actualiza la longitud y los miembros de longitud máxima de DestinationString en consecuencia.

[in] SourceString

Puntero a la cadena OEM que se va a traducir a Unicode.

[in] AllocateDestinationString

Se establece en TRUE si RtlOemStringToUnicodeString debe asignar el espacio de búfer para DestinationString, FALSE de lo contrario. 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 RtlFreeUnicodeString.

Valor devuelto

RtlOemStringToUnicodeString devuelve STATUS_SUCCESS si devuelve una cadena traducida en DestinationString. De lo contrario, no se asignó ningún almacenamiento y no se realizó ninguna conversión.

Comentarios

RtlOemStringToUnicodeString 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.

Esta rutina no modifica la cadena de origen. Devuelve una cadena Unicode 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).