Función RtlDowncaseUnicodeString (ntifs.h)
La rutina RtlDowncaseUnicodeString convierte la cadena de origen Unicode especificada en minúsculas. La traducción se ajusta a la información de configuración regional del sistema actual.
Sintaxis
NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
PUNICODE_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 Unicode convertida. Si AllocateDestinationString es FALSE, el autor de la llamada también debe asignar un búfer para que el miembro Buffer de DestinationString contenga los datos Unicode. Si AllocateDestinationString es TRUE, RtlDowncaseUnicodeString 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 Unicode de origen que se va a convertir en minúsculas.
[in] AllocateDestinationString
Se establece en TRUE si RtlDowncaseUnicodeString debe asignar el espacio de búfer para DestinationString; de lo contrario, FALSE . 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 RtlFreeUnicodeString.
Valor devuelto
Si la operación se realiza correctamente, RtlDowncaseUnicodeString devuelve STATUS_SUCCESS. De lo contrario, no se asignó ningún almacenamiento y no se realizó ninguna conversión.
Comentarios
Si el llamador establece AllocateDestinationString en TRUE, RtlDowncaseUnicodeString reemplaza el miembro Buffer de DestinationString por un puntero al búfer que asigna. El valor anterior se puede sobrescribir incluso cuando la rutina devuelve un código de estado de error.
RtlDowncaseUnicodeString no modifica la cadena de origen.
Para obtener información sobre otras rutinas de control de cadenas, vea Rutinas de la biblioteca en tiempo de ejecución (RTL).
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |