RtlUnicodeStringValidate-Funktion (ntstrsafe.h)

  • Artikel

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
STATUS_SUCCESS
 Dieser Erfolg status bedeutet, dass die Funktion erfolgreich abgeschlossen wurde.
STATUS_INVALID_PARAMETER
 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.
Informationen zum Testen von NTSTATUS-Werten finden Sie unter Verwenden von NTSTATUS-Werten.

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 PASSIVE_LEVEL

Weitere Informationen

RtlUnicodeStringValidateEx

UNICODE_STRING