Función RtlUpcaseUnicodeToOemN (ntifs.h)

Artículo
02/26/2024

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

Sintaxis

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
  [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 de 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 en UnicodeString se ha traducido correctamente, convertido en mayúsculas y devuelto en OemString. De lo contrario, puede devolver STATUS_BUFFER_OVERFLOW si la cadena de destino debe truncarse para ajustarse a maxBytesInOemString determinada.

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 del valor MaxBytesInOemString especificado.

Esta rutina no modifica la cadena de origen. Devuelve una cadena OEM terminada en NULL si bytesInUnicodeString especificados incluía un terminador NULL y si maxBytesInOemString especificado no provocaba truncamiento.

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