RtlInitStringEx-Funktion (wdm.h)

  • Artikel

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

Anforderung Wert
Unterstützte Mindestversion (Client) Ab Windows 10 verfügbar.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.

Weitere Informationen

ANSI_STRING