Función RtlUnicodeStringToUTF8String (wdm.h)
La función RtlUnicodeStringToUTF8String convierte la cadena de origen Unicode especificada en una cadena UTF8.
Sintaxis
NTSYSAPI NTSTATUS RtlUnicodeStringToUTF8String(
PUTF8_STRING DestinationString,
PCUNICODE_STRING SourceString,
BOOLEAN AllocateDestinationString
);
Parámetros
DestinationString
Puntero a una estructura de UTF8_STRING para contener la cadena UTF8 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. El campo de longitud máxima solo se establece si AllocateDestinationString es TRUE.
SourceString
Puntero a la cadena de origen Unicode que se va a convertir en UTF8.
AllocateDestinationString
TRUE si esta rutina es asignar el espacio de búfer para DestinationString. Si es así, el búfer debe desasignarse llamando a RtlFreeUTF8String.
Valor devuelto
Si la conversión se realiza correctamente, RtlUnicodeStringToUTF8String devuelve STATUS_SUCCESS. Si se produce un error, la rutina no asigna memoria ni realiza una conversión.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 2004 |
| Encabezado | wdm.h |
| IRQL | PASSIVE_LEVEL |