RtlCopyUnicodeString-Funktion (wdm.h)

  • Artikel

Die RtlCopyUnicodeString-Routine kopiert eine Quellzeichenfolge in eine Zielzeichenfolge.

Syntax

NTSYSAPI VOID RtlCopyUnicodeString(
  [in, out]      PUNICODE_STRING  DestinationString,
  [in, optional] PCUNICODE_STRING SourceString
);

Parameter

[in, out] DestinationString

Ein Zeiger auf den Zielzeichenfolgenpuffer. Dieser Parameter verweist auf eine UNICODE_STRING-Struktur .

[in, optional] SourceString

Ein Zeiger auf den Quellzeichenfolgenpuffer. Dieser Parameter verweist auf eine UNICODE_STRING-Struktur .

Rückgabewert

Keine

Bemerkungen

Wenn SourceStringNULL ist, legt diese Routine das Length-Feld der Struktur fest, auf die destinationString zeigt.

Diese Routine ändert nicht die Felder MaximumLength und Buffer der Struktur, auf die von DestinationString verwiesen wird.

Die Anzahl der aus der Quellzeichenfolge kopierten Bytes ist entweder die Länge der Quellzeichenfolge (angegeben durch den Length-Member der Struktur, auf die durch SourceString verwiesen wird) oder die maximale Länge der Zielzeichenfolge (angegeben durch den MaximumLength-Member der Struktur, auf die von DestinationString verwiesen wird), je nachdem, welcher Wert kleiner ist.

Der Aufrufer muss alle Member der Struktur, auf die von DestinationString verwiesen wird, ordnungsgemäß initialisieren, bevor RtlCopyUnicodeString aufgerufen wird. Wenn der Length - oder MaximumLength-Member vor dem Aufruf dieser Routine nicht initialisiert wird, kann dies zu einem Pufferüberlauf führen.

Die Puffer DestinationString und SourceString müssen resident sein, wenn der Aufrufer unter IRQL >= DISPATCH_LEVEL ausgeführt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL Beliebige Ebene (siehe Abschnitt "Hinweise")

Weitere Informationen

RtlCopyString

UNICODE_STRING