Función RtlUTF8StringToUnicodeString (wdm.h)

  • Artículo

La función RtlUTF8StringToUnicodeString convierte la cadena de origen UTF8 especificada en una cadena Unicode de acuerdo con la información de configuración regional del sistema actual.

Sintaxis

NTSYSAPI NTSTATUS RtlUTF8StringToUnicodeString(
  PUNICODE_STRING DestinationString,
  PUTF8_STRING    SourceString,
  BOOLEAN         AllocateDestinationString
);

Parámetros

DestinationString

Puntero a una estructura UNICODE_STRING que contiene la cadena Unicode convertida.

Si AllocateDestinationString es TRUE, la rutina asigna un nuevo búfer para contener los datos de cadena, actualiza el miembro Buffer de DestinationString para que apunte al nuevo búfer y establezca el campo de longitud máxima. De lo contrario, la rutina usa el búfer especificado actualmente para contener la cadena.

SourceString

Puntero a la cadena UTF8 que se va a convertir en Unicode.

AllocateDestinationString

Especifica si esta rutina debe asignar el espacio de búfer para la cadena de destino. Si es así, el autor de la llamada debe desasignar el búfer llamando a RtlFreeUnicodeString.

Valor devuelto

Si la conversión se realiza correctamente, RtlUTF8StringToUnicodeString devuelve STATUS_SUCCESS. En caso de 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

RtlFreeUnicodeString