Función RtlUnicodeToOemN (ntifs.h)

Artículo
02/29/2024

La rutina RtlUnicodeToOemN traduce una cadena Unicode determinada a una cadena OEM mediante la página de códigos oem del sistema actual.

Sintaxis

NTSYSAPI NTSTATUS RtlUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parámetros

[out] OemString

Puntero a un búfer asignado por el autor de la llamada para recibir la cadena traducida.

[in] MaxBytesInOemString

Número máximo de bytes que se van a escribir en OemString.

[out, optional] BytesInOemString

Puntero a una variable asignada por el autor de la llamada que recibe el número de bytes en la cadena traducida. Este parámetro puede ser NULL.

[in] UnicodeString

Puntero a la cadena de origen Unicode que se va a traducir.

[in] BytesInUnicodeString

Tamaño, en bytes, de la cadena en UnicodeString.

Valor devuelto

RtlUnicodeToOemN devuelve STATUS_SUCCESS si la cadena completa de UnicodeString se ha traducido y devuelto en OemString.

Comentarios

Para el valor devuelto STATUS_BUFFER_OVERFLOW, la cadena truncada en OemString se traducía sin errores.

Para el valor devuelto STATUS_SUCCESS, el valor en BytesInOemString, si existe, indica la longitud de la cadena devuelta, en lugar de la clase MaxBytesInOemString especificada.

RtlUnicodeToOemN no modifica la cadena de origen. Devuelve una cadena OEM terminada en null si bytesinunicodeString especificados incluía un terminador NULL y si el maxBytesInOemString especificado no provocó el truncamiento.

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