RtlInitUTF8String-Funktion (wdm.h)

Die RtlInitUTF8String-Funktion initialisiert eine gezählte Zeichenfolge mit UTF-8-Zeichen.

Syntax

NTSYSAPI VOID RtlInitUTF8String(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

Parameter

DestinationString

Ein Zeiger auf UTF8_STRING (STRING)-Struktur, die initialisiert werden soll.

SourceString

Optionaler 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

Keine

Bemerkungen

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.

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

Anforderungen

Weitere Informationen

RtlInitAnsiString