RtlInitUTF8StringEx-Funktion (wdm.h)

  • Artikel

Die RtlInitUTF8StringEx-Routine initialisiert eine gezählte Zeichenfolge mit UTF-8-Zeichen.

Syntax

NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

Parameter

DestinationString

Ein Zeiger auf die UTF8_STRING Struktur, die initialisiert werden soll. Die Ntdef.h-Headerdatei definiert diese Struktur so, dass sie mit der STRING-Struktur identisch ist.

SourceString

Ein Zeiger auf eine Zeichenfolge mit NULL-Beendigung. Diese Zeichenfolge wird verwendet, um die gezählte Zeichenfolge zu initialisieren, auf die von DestinationString verwiesen wird.

Rückgabewert

Gibt STATUS_NAME_TOO_LONG zurück, wenn der SourceString zu lang ist. Andernfalls gibt diese Routine STATUS_SUCCESS zurück.

Hinweise

Die Routine kopiert den SourceString-Zeigerwert in das Buffer-Element der UTF8_STRING Struktur, auf die von DestinationString verwiesen wird. Das Length-Element dieser Struktur ist auf die Länge (in Bytes) der Quellzeichenfolge festgelegt, wobei der beendende NULL-Wert ausgeschlossen ist. Das MaximumLength-Element der Struktur ist auf die Länge (in Bytes) der Quellzeichenfolge festgelegt, einschließlich des beendenden NULL. Wenn SourceStringNULL ist, werden Length und MaximumLength auf 0 festgelegt.

RtlInitUTF8StringEx ändert nicht die Quellzeichenfolge, auf die von SourceString verwiesen wird.

Aufrufer von RtlInitUTF8StringEx können unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn der DestinationString-Puffer nicht ausführbar ist. In der Regel werden Aufrufer mit IRQL = PASSIVE_LEVEL ausgeführt, da die meisten anderen RtlXxxString-Routinen nicht bei IRQL > PASSIVE_LEVEL aufgerufen werden können.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004
Kopfzeile wdm.h
IRQL <= DISPATCH_LEVEL

Weitere Informationen

RtlInitAnsiString