RtlUnicodeStringValidate-Funktion (ntstrsafe.h)
Die RtlUnicodeStringValidate-Funktion überprüft den Inhalt einer UNICODE_STRING-Struktur .
Syntax
NTSTRSAFEDDI RtlUnicodeStringValidate(
[in] PCUNICODE_STRING SourceString
);
Parameter
[in] SourceString
Ein Zeiger auf eine UNICODE_STRING Struktur, die überprüft werden soll.
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->Die Länge %sizeof(WCHAR) ist nicht gleich Null.
- SourceString->MaximumLength % sizeof(WCHAR) ist nicht gleich Null.
- SourceString->Length ist größer als SourceString->MaximumLength.
- SourceString->MaximumLength ist größer als NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
- SourceString->Der Puffer ist gleich NULL , aber SourceString->Length oder SourceString->MaximumLength ist nicht gleich Null.
Hinweise
Der SourceString-Zeiger darf nicht NULL sein. Wenn Sie einen NULL-Zeigerwert angeben müssen, verwenden Sie die RtlUnicodeStringValidateEx-Funktion .
Weitere Informationen zu den sicheren Zeichenfolgenfunktionen finden Sie unter Verwenden sicherer Zeichenfolgenfunktionen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar in Windows XP mit Service Pack 1 (SP1) und höheren Versionen von Windows. |
Zielplattform | Desktop |
Kopfzeile | ntstrsafe.h (einschließen von Ntstrsafe.h) |
Bibliothek | Ntstrsafe.lib |
IRQL | Alle, wenn Zeichenfolgen, die bearbeitet werden, immer im Arbeitsspeicher gespeichert sind, andernfalls PASSIVE_LEVEL |