Función RtlUnicodeStringToUTF8String (wdm.h)

  • Artículo

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

Consulte también

RtlFreeUTF8String