WdmlibRtlInitUnicodeStringEx-Funktion (wdmsec.h)

  • Artikel

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 UNICODE_STRING Struktur, die initialisiert werden soll.

[in, optional] SourceString

Ein Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge. Diese Zeichenfolge wird verwendet, um die gezählte Zeichenfolge zu initialisieren, auf die von DestinationString verwiesen wird.

Rückgabewert

WdmlibRtlInitUnicodeStringEx gibt bei erfolgreicher Ausführung STATUS_SUCCESS zurück, andernfalls gibt die Methode möglicherweise andere NTSTATUS-Werte zurück.

Hinweise

Die Routine kopiert den SourceString-Zeigerwert in das Buffer-Element der UNICODE_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.

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

Hinweis

Wenn die Quellzeichenfolge länger als MAX_USTRING - 1 Bytes ist, legt WdmlibRtlInitUnicodeStringEx das Length-Element der UNICODE_STRING Struktur, auf die von DestinationString verwiesen wird, auf MAX_USTRING - 2 fest und legt das MaximumLength-Element dieser Struktur auf MAX_USTRING fest. In diesem Fall stellen die Werte Length und MaximumLength die Länge der null-beendeten Quellzeichenfolge falsch dar, und die Abhängigkeit von der Genauigkeit dieser Werte ist potenziell gefährlich.

Aufrufer von WdmlibRtlInitUnicodeStringEx können unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn der DestinationString-Puffer nicht ausstellbar ist. In der Regel werden Aufrufer mit IRQL = PASSIVE_LEVEL ausgeführt, da die meisten anderen RtlXxxString-Routinen nicht bei IRQL > PASSIVE_LEVEL aufgerufen werden können.

Anforderungen

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

Weitere Informationen