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 |