Freigeben über


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

Weitere Informationen

RtlFreeUTF8String