RtlInitStringEx-Funktion (wdm.h)

Die RtlInitStringEx-Routine initialisiert eine gezählte Zeichenfolge mit 8-Bit-Zeichen.

Syntax

NTSYSAPI NTSTATUS RtlInitStringEx(
  [out]          PSTRING               DestinationString,
  [in, optional] __drv_aliasesMem PCSZ SourceString
);

Parameter

[out] DestinationString

Ein Zeiger auf die zu initialisierende STRING-Struktur . Die Ntdef.h-Headerdatei definiert diese Struktur so, dass sie mit der ANSI_STRING-Struktur identisch ist.

[in, optional] SourceString

Ein Zeiger auf eine NULL-endende Zeichenfolge. 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 sourceString zu lang ist. Andernfalls gibt diese Routine STATUS_SUCCESS zurück.

Hinweise

Diese Routine initialisiert eine gezählte Zeichenfolge.

Die Routine kopiert den SourceString-Zeigerwert in den Buffer-Member der STRING-Struktur, auf die von DestinationString verwiesen wird. Der Length-Member dieser Struktur wird auf die Länge (in Bytes) der Quellzeichenfolge festgelegt, wobei der abschließende NULL-Wert ausgeschlossen ist. Der MaximumLength-Member der -Struktur wird auf die Länge der Quellzeichenfolge in Byte festgelegt, 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

Weitere Informationen

ANSI_STRING