RtlUTF8StringToUnicodeString-Funktion (wdm.h)

Die RtlUTF8StringToUnicodeString-Funktion konvertiert die angegebene UTF8-Quellzeichenfolge gemäß den aktuellen Systemgebietsschemainformationen in eine Unicode-Zeichenfolge.

Syntax

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

Parameter

DestinationString

Zeiger auf eine UNICODE_STRING Struktur, die die konvertierte Unicode-Zeichenfolge enthält.

Wenn AllocateDestinationStringTRUE ist, weist die Routine einen neuen Puffer zu, der die Zeichenfolgendaten enthält, aktualisiert den Puffermember von DestinationString , um auf den neuen Puffer zu zeigen, und legt das Feld für die maximale Länge fest. Andernfalls verwendet die Routine den aktuell angegebenen Puffer, um die Zeichenfolge zu halten.

SourceString

Zeiger auf die UTF8-Zeichenfolge, die in Unicode konvertiert werden soll.

AllocateDestinationString

Gibt an, ob diese Routine den Pufferspeicher für die Zielzeichenfolge zuordnen soll. Wenn dies der Fall ist, muss der Aufrufer die Zuordnung des Puffers durch Aufrufen von RtlFreeUnicodeString beheben.

Rückgabewert

Wenn die Konvertierung erfolgreich ist, gibt RtlUTF8StringToUnicodeString STATUS_SUCCESS zurück. Bei Einem Fehler ordnet die Routine weder Arbeitsspeicher zu, noch führt sie eine Konvertierung durch.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 2004
Kopfzeile	wdm.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

RtlFreeUnicodeString