RtlInitStringEx-Funktion (ntifs.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 STRING- Struktur, die initialisiert werden soll. Die Headerdatei Ntdef.h definiert diese Struktur so, dass sie mit der ANSI_STRING Struktur identisch ist.
[in, optional] SourceString
Ein Zeiger auf eine mit Null beendete Zeichenfolge. Diese Zeichenfolge wird verwendet, um die gezählte Zeichenfolge zu initialisieren, auf die DestinationString-verweist.
Rückgabewert
Gibt STATUS_NAME_TOO_LONG zurück, wenn die SourceString zu lang ist. Andernfalls gibt diese Routine STATUS_SUCCESS zurück.
Bemerkungen
Diese Routine initialisiert eine gezählte Zeichenfolge.
Die Routine kopiert den SourceString Zeigerwert in das Buffer Member der STRING Struktur, auf die durch DestinationString-verwiesen wird. Das Length Member dieser Struktur wird auf die Länge der Quellzeichenfolge in Byte festgelegt, mit Ausnahme der endenden NULL. Der MaximumLength- Member der Struktur wird auf die Länge der Quellzeichenfolge in Bytes festgelegt, 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. |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Siehe Abschnitt "Hinweise". |