RtlAppendUnicodeToString-Funktion (wdm.h)
Die RtlAppendUnicodeToString-Routine verkettet die angegebene Unicode-Zeichenfolge mit einer gepufferten Unicode-Zeichenfolge.
Syntax
NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
[in, out] PUNICODE_STRING Destination,
[in, optional] PCWSTR Source
);
Parameter
[in, out] Destination
Ein Zeiger auf die gepufferte Zeichenfolge.
[in, optional] Source
Ein Zeiger auf die NULL-endende Zeichenfolge, die an die Zielzeichenfolge angefügt werden soll.
Rückgabewert
RtlAppendUnicodeToString kann eine der folgenden Aktionen zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Quellzeichenfolge wurde erfolgreich an die Zielzeichenfolge angefügt, und die Länge der Zielzeichenfolge wurde aktualisiert, um die angefügten Bytes einzuschließen. |
|
Der Zielzeichenfolgenpuffer ist zu klein, um das Anfügen der Quellzeichenfolge zu ermöglichen, sodass die Länge der Zielzeichenfolge nicht aktualisiert wird und der Inhalt des Zielzeichenfolgenpuffers nicht geändert wird. |
Hinweise
RtlAppendUnicodeToString fügt die Quellzeichenfolge an das Ende der Zielzeichenfolge an.
Wenn der Zielpuffer nicht groß genug ist, um die Zeichenfolge zu enthalten, die sich aus der Verkettung der Quell- und Zielzeichenfolge ergeben würde (ohne das NULL-Zeichen, das die Quellzeichenfolge beendet), gibt die Routine STATUS_BUFFER_TOO_SMALL zurück und lässt die Zielzeichenfolge unverändert.
Der Zielpuffer muss 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 | Weitere Informationen finden Sie im Abschnitt mit den Hinweisen. |