Función RtlUnicodeStringToOemString (winternl.h)

  • Artículo

Convierte la cadena de origen Unicode especificada en una cadena oem. La traducción se realiza con respecto a la página de códigos oem (OCP).

Sintaxis

NTSTATUS RtlUnicodeStringToOemString(
  [out] POEM_STRING      DestinationString,
  [in]  PCUNICODE_STRING SourceString,
  [in]  BOOLEAN          AllocateDestinationString
);

Parámetros

[out] DestinationString

Puntero a una estructura OEM_STRING que contiene el OEM equivalente a la cadena de origen Unicode. El campo MaximumLength se establece si AllocateDestinationString es TRUE.

[in] SourceString

Puntero a una estructura UNICODE_STRING que se va a convertir en OEM.

[in] AllocateDestinationString

Controla la asignación del espacio de búfer para la cadena de destino.

TRUE

Se asigna espacio de búfer para DestinationString. Si se establece en TRUE, el búfer debe desasignarse mediante RtlFreeOemString.

FALSE

No se asigna espacio de búfer para DestinationString.

Valor devuelto

Los distintos valores NTSTATUS se definen en NTSTATUS. H, que se distribuye con el DDK de Windows.

Código devuelto Descripción
STATUS_SUCCESS
 La cadena Unicode se convirtió en OEM. De lo contrario, no se asignó ningún almacenamiento y no se realizó ninguna conversión.

Comentarios

Esta rutina asigna un búfer solo para DestinationString .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winternl.h
Library ntdll.lib
Archivo DLL ntdll.dll