RtlUnicodeStringToUTF8String-Funktion (wdm.h)
Die RtlUnicodeStringToUTF8String-Funktion konvertiert die angegebene Unicode-Quellzeichenfolge in eine UTF8-Zeichenfolge.
Syntax
NTSYSAPI NTSTATUS RtlUnicodeStringToUTF8String(
PUTF8_STRING DestinationString,
PCUNICODE_STRING SourceString,
BOOLEAN AllocateDestinationString
);
Parameter
DestinationString
Zeiger auf eine UTF8_STRING Struktur, die die konvertierte UTF8-Zeichenfolge enthält. Wenn AllocateDestinationStringTRUE ist, weist die Routine einen neuen Puffer zu, der die Zeichenfolgendaten enthält, und aktualisiert den Buffer-Member von DestinationString so, dass er auf den neuen Puffer verweist. Andernfalls verwendet die Routine den aktuell angegebenen Puffer, um die Zeichenfolge zu halten. Das Feld für die maximale Länge wird nur festgelegt, wenn "AllocateDestinationString " true ist.
SourceString
Zeiger auf die Unicode-Quellzeichenfolge, die in UTF8 konvertiert werden soll.
AllocateDestinationString
TRUE , wenn diese Routine den Pufferspeicher für destinationString zuordnen soll. Wenn dies der Fall ist, muss der Puffer durch Aufrufen von RtlFreeUTF8String aufgehoben werden.
Rückgabewert
Wenn die Konvertierung erfolgreich ist, gibt RtlUnicodeStringToUTF8String 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 |