Función RtlUnicodeStringToCountedOemString (ntifs.h)

2025-02-07

La rutina de RtlUnicodeStringToCountedOemString convierte la cadena de origen Unicode especificada en una cadena oem con recuento mediante la página de códigos del OEM del sistema actual.

Sintaxis

NTSYSAPI NTSTATUS RtlUnicodeStringToCountedOemString(
       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 el miembro buffer deDestinationString para contener los datos del OEM. Si AllocateDestinationString es TRUE, RtlUnicodeStringToCountedOemString asigna un búfer lo suficientemente grande como para contener la cadena, pasa un puntero a ella en Buffery actualiza la longitud y los miembros de longitud máxima de DestinationString en consecuencia.

[in] SourceString

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

[in] AllocateDestinationString

Establézcalo en TRUE si rtlUnicodeStringToCountedOemString debe asignar el espacio de búfer para el destinationString de, 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 llamando a RtlFreeOemString.

Valor devuelto

rtlUnicodeStringToCountedOemString devuelve STATUS_SUCCESS si se traduce la cadena en DestinationString. De lo contrario, no se asignó ningún almacenamiento y no se realizó ninguna conversión. Esta rutina devuelve STATUS_UNMAPPABLE_CHARACTER si no puede traducir un carácter en el SourceString especificado.

Observaciones

rtlUnicodeStringToCountedOemString devuelve una cadena traducida que no incluye un terminador NULL. 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.

rtlUnicodeStringToCountedOemString no modifica la cadena de origen.

Para obtener información sobre otras rutinas de control de cadenas, consulte rutinas de Run-Time Library (RTL).

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	< DISPATCH_LEVEL