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 mit Null beendete Zeichenfolge. SourceString- wird verwendet, um die gezählte Zeichenfolge zu initialisieren, auf die DestinationString verweist.
Rückgabewert
RtlInitUTF8StringEx gibt STATUS_NAME_TOO_LONG zurück, wenn die SourceString- zu lang ist. Andernfalls gibt diese Routine STATUS_SUCCESS zurück.
Bemerkungen
RtlInitUTF8StringEx legt die Elemente der UTF8_STRING Struktur fest, die DestinationString wie folgt verweist:
Kopiert den Zeigerwert SourceString- in das element Buffer.
Legt den Length Member auf die Länge der Quellzeichenfolge in Byte fest, mit Ausnahme des endenden Null.
Legt den MaximumLength Member auf die Länge der Quellzeichenfolge in Byte fest, einschließlich der endenden NULL.
Wenn SourceString-NULL-ist, werden Length und MaximumLength- auf Null festgelegt.
RtlInitStringEx ändert nicht die Quellzeichenfolge, auf die durch SourceString-verwiesen wird.
Aufrufer von RtlInitStringEx- können bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn der DestinationString- Puffer nicht ausgelagert werden kann. In der Regel werden Anrufer bei IRQL = PASSIVE_LEVEL ausgeführt, da die meisten anderen Rtl-Xxx-String- Routinen nicht bei IRQL-> PASSIVE_LEVEL aufgerufen werden können.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 2004 |
| Header- | ntifs.h |