RtlAppendUnicodeToString-Funktion (wdm.h)

  • Artikel

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
STATUS_SUCCESS
 Die Quellzeichenfolge wurde erfolgreich an die Zielzeichenfolge angefügt, und die Länge der Zielzeichenfolge wurde aktualisiert, um die angefügten Bytes einzuschließen.
STATUS_BUFFER_TOO_SMALL
 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.

Weitere Informationen

RtlAppendUnicodeStringToString