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 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. |