RtlUnicodeStringCopyString-Funktion (ntstrsafe.h)
Die RtlUnicodeStringCopyString--Funktion kopiert eine Zeichenfolge in eine UNICODE_STRING Struktur.
Syntax
NTSTRSAFEDDI RtlUnicodeStringCopyString(
[out] PUNICODE_STRING DestinationString,
[in] NTSTRSAFE_PCWSTR pszSrc
);
Parameter
[out] DestinationString
Ein Zeiger auf eine UNICODE_STRING Struktur, die die kopierte Zeichenfolge empfängt. Die Zeichenfolge, auf die der pszSrc Parameter verweist (mit Ausnahme des endierenden Null), wird in den Puffer kopiert, auf den der DestinationString Parameter UNICODE_STRING Struktur verweist. Die maximale Anzahl von Bytes in der Zeichenfolge ist NTSTRSAFE_UNICODE_STRING_MAX_CCH * Größe des(WCHAR).
[in] pszSrc
Ein Zeiger auf eine mit Null beendete Zeichenfolge. Diese Zeichenfolge wird in den Puffer kopiert, auf den die UNICODE_STRINGDestinationString--Parameterstruktur verweist.
Rückgabewert
RtlUnicodeStringCopyString gibt einen der folgenden NTSTATUS-Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Dieser Erfolg Status bedeutet, dass Quelldaten vorhanden waren und die Zeichenfolge ohne Abkürzung kopiert wurde. |
|
Diese Warnung Status bedeutet, dass der Kopiervorgang aufgrund unzureichender Pufferspeicher nicht abgeschlossen wurde. Der Zielpuffer enthält eine abgeschnittene, null-beendete Version des beabsichtigten Ergebnisses. |
|
Dieser Fehler Status bedeutet, dass die Funktion einen ungültigen Eingabeparameter empfangen hat. Weitere Informationen finden Sie in der folgenden Liste. |
RtlUnicodeStringCopyString gibt den STATUS_INVALID_PARAMETER Wert zurück, wenn einer der folgenden Aktionen auftritt:
- Der Inhalt der UNICODE_STRING-Struktur ist ungültig.
- Der Zielpuffer ist bereits voll.
- Ein Pufferzeiger ist NULL-.
- Die Länge des Zielpuffers ist null, aber eine Zeichenfolge mit nicht nuller Länge ist vorhanden.
Bemerkungen
Die RtlUnicodeStringCopyString--Funktion verwendet die Größe des Zielpuffers, um sicherzustellen, dass der Verkettungsvorgang nicht über das Ende des Puffers schreibt. Die Funktion beendet die resultierende Zeichenfolge nicht mit einem NULL-Zeichen.
Wenn sich die Quell- und Zielzeichenfolgen überschneiden, wird das Verhalten der Funktion nicht definiert.
Die pszSrc und DestinationString Zeiger können nicht NULL-werden. Wenn Sie NULL- Zeigerwerte behandeln müssen, verwenden Sie die funktion RtlUnicodeStringCopyStringEx.
Weitere Informationen zu den sicheren Zeichenfolgenfunktionen finden Sie unter Verwenden von Funktionen für sichere Zeichenfolgen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows XP mit Service Pack 1 (SP1) und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | ntstrsafe.h (include Ntstrsafe.h) |
| Library | Ntstrsafe.lib |
| IRQL- | Wenn Zeichenfolgen, die bearbeitet werden, immer im Arbeitsspeicher vorhanden sind, andernfalls PASSIVE_LEVEL |