RtlInitUTF8StringEx-Funktion (ntifs.h)
RtlInitUTF8StringEx initialisiert eine gezählte Zeichenfolge mit UTF-8-Zeichen.
Syntax
NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
PUTF8_STRING DestinationString,
__drv_aliasesMem PCSZ SourceString
);
Parameter
DestinationString
Zeiger auf die zu initialisierende UTF8_STRING-Struktur. Die Ntdef.h-Headerdatei definiert diese Struktur so, dass sie mit der ANSI_STRING-Struktur identisch ist.
SourceString
Zeiger auf eine NULL-endende Zeichenfolge. SourceString wird verwendet, um die gezählte Zeichenfolge zu initialisieren, auf die DestinationString zeigt.
Rückgabewert
RtlInitUTF8StringEx gibt STATUS_NAME_TOO_LONG zurück, wenn sourceString zu lang ist. Andernfalls gibt diese Routine STATUS_SUCCESS zurück.
Hinweise
RtlInitUTF8StringEx legt die Member der UTF8_STRING-Struktur fest, auf die DestinationString wie folgt zeigt:
Kopiert den Zeigerwert von SourceString in das Buffer-Element .
Legt den Length-Member auf die Länge (in Byte) der Quellzeichenfolge fest, wobei der abschließende NULL-Wert ausgeschlossen wird.
Legt den MaximumLength-Member auf die Länge (in Byte) der Quellzeichenfolge fest, einschließlich der endenden NULL.
Wenn SourceStringNULL ist, werden Length und MaximumLength auf 0 festgelegt.
RtlInitStringEx ändert nicht die Quellzeichenfolge, auf die von SourceString verwiesen wird.
Aufrufer von RtlInitStringEx können unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn der DestinationString-Puffer nicht auslagerbar ist. In der Regel werden Aufrufer mit IRQL = PASSIVE_LEVEL ausgeführt, da die meisten anderen RtlXxxString-Routinen nicht im IRQL-PASSIVE_LEVEL > aufgerufen werden können.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 2004 |
| Kopfzeile | ntifs.h |