Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die WdmlibRtlInitUnicodeStringEx--Funktion initialisiert eine gezählte Zeichenfolge von Unicode-Zeichen.
Syntax
NTSTATUS WdmlibRtlInitUnicodeStringEx(
[out] PUNICODE_STRING DestinationString,
[in, optional] PCWSTR SourceString
);
Parameter
[out] DestinationString
Ein Zeiger auf die zu initialisierende UNICODE_STRING Struktur.
[in, optional] SourceString
Ein Zeiger auf eine mit Null beendete breite Zeichenfolge. Diese Zeichenfolge wird verwendet, um die gezählte Zeichenfolge zu initialisieren, auf die DestinationString-verweist.
Rückgabewert
WdmlibRtlInitUnicodeStringEx gibt bei erfolgreicher Ausführung STATUS_SUCCESS zurück, andernfalls gibt die Methode möglicherweise andere NTSTATUS-Werte zurück.
Bemerkungen
Die Routine kopiert den SourceString Zeigerwert in das Buffer Member der UNICODE_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.
WdmlibRtlInitUnicodeStringEx ändert nicht die Quellzeichenfolge, auf die durch SourceString-verwiesen wird.
Anmerkung
Wenn die Quellzeichenfolge länger als MAX_USTRING - 1 Byte ist (wobei MAX_USTRING = 0xfffe), legt WdmlibRtlInitUnicodeStringEx das Length Member der UNICODE_STRING Struktur fest, auf das durch DestinationString- auf MAX_USTRING - 2 verwiesen wird, und legt das MaximumLength-Element dieser Struktur auf MAX_USTRING fest. In diesem Fall stellen die Length und MaximumLength- Werte die Länge der null-beendeten Quellzeichenfolge falsch dar, und das Vertrauen auf die Genauigkeit dieser Werte ist potenziell gefährlich.
Aufrufer von WdmlibRtlInitUnicodeStringEx- können unter 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- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdmsec.h (include Wdmsec.h, Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Siehe Abschnitt "Hinweise". |