Función RtlUnicodeStringToAnsiString (wdm.h)
La rutina RtlUnicodeStringToAnsiString convierte una cadena Unicode determinada en una cadena ANSI.
Sintaxis
NTSYSAPI NTSTATUS RtlUnicodeStringToAnsiString(
[in, out] PANSI_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Parámetros
[in, out] DestinationString
Puntero a una estructura de ANSI_STRING para contener la cadena ANSI convertida. Si AllocateDestinationString es TRUE, la rutina asigna un nuevo búfer para contener los datos de cadena y actualiza el miembro buffer de DestinationString para que apunte al nuevo búfer. De lo contrario, la rutina usa el búfer especificado actualmente para contener la cadena.
[in] SourceString
Puntero a la cadena de origen Unicode que se va a convertir en ANSI.
[in] AllocateDestinationString
TRUE si esta rutina es asignar el espacio de búfer para DestinationString. Si es así, el búfer debe desasignarse llamando a RtlFreeAnsiString.
Valor devuelto
Si la conversión se realiza correctamente, RtlUnicodeStringToAnsiString devuelve STATUS_SUCCESS. De lo contrario, no se asignó ningún almacenamiento y no se realizó ninguna conversión.
Comentarios
La traducción se realiza de acuerdo con la información actual de configuración regional del sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |