RtlUnicodeStringValidate-Funktion (ntstrsafe.h)
Die funktion RtlUnicodeStringValidate überprüft den Inhalt einer UNICODE_STRING Struktur.
Syntax
NTSTRSAFEDDI RtlUnicodeStringValidate(
[in] PCUNICODE_STRING SourceString
);
Parameter
[in] SourceString
Ein Zeiger auf eine zu überprüfende UNICODE_STRING Struktur.
Rückgabewert
RtlUnicodeStringValidate gibt einen der folgenden NTSTATUS-Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Dieser Erfolg Status bedeutet, dass die Funktion erfolgreich abgeschlossen wurde. |
|
Dieser Fehler Status bedeutet, dass die Funktion einen ungültigen Eingabeparameter empfangen hat. Weitere Informationen finden Sie in der folgenden Liste. |
RtlUnicodeStringValidate gibt den STATUS_INVALID_PARAMETER Wert zurück, wenn einer der folgenden Aktionen auftritt:
- SourceString->Length % sizeof(WCHAR) ist ungleich Null.
- SourceString->MaximumLength % sizeof(WCHAR) ist ungleich Null.
- SourceString->Length größer als SourceString->MaximumLength.
- SourceString->MaximumLength größer als NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
- SourceString-->Buffer- entspricht NULL-, aber SourceString->Length oder SourceString->MaximumLength ungleich Null ist.
Bemerkungen
Der SourceString Zeiger kann nicht NULL-werden. Wenn Sie einen NULL- Zeigerwert angeben müssen, verwenden Sie die funktion RtlUnicodeStringValidateEx.
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 |