RtlCopyUnicodeString-Funktion (wdm.h)
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") |