RtlUnicodeStringValidateEx-Funktion (ntstrsafe.h)
Die RtlUnicodeStringValidateEx-Funktion überprüft den Inhalt einer UNICODE_STRING-Struktur .
Syntax
NTSTRSAFEDDI RtlUnicodeStringValidateEx(
[in] PCUNICODE_STRING SourceString,
[in] DWORD dwFlags
);
Parameter
[in] SourceString
Optional. Ein Zeiger auf eine UNICODE_STRING Struktur, die überprüft werden soll. Dieser Zeiger kann NULL sein, aber nur, wenn STRSAFE_IGNORE_NULLS in dwFlags festgelegt ist.
[in] dwFlags
Das folgende Flag ist definiert:
STRSAFE_IGNORE_NULLS
Wenn dieses Flag festgelegt ist, kann der Quellzeiger NULL sein. RtlUnicodeStringValidateEx behandelt NULL-Quellpufferzeiger wie leere Zeichenfolgen (TEXT("")).
Rückgabewert
RtlUnicodeStringValidateEx 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. |
Wenn STRSAFE_IGNORE_NULLS in dwFlags nicht festgelegt ist, gibt RtlUnicodeStringValidateEx 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.
- Für dwFlags wird ein ungültiges Flag angegeben.
Hinweise
Der SourceString-Zeiger kann nicht NULL sein, es sei denn, das flag STRSAFE_IGNORE_NULLS ist festgelegt.
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 |