Freigeben über


FsRtlIsNameInUnUpcasedExpression-Funktion (ntifs.h)

Die FsRtlIsNameInUnUpcasedExpression Routine bestimmt, ob eine Unicode-Zeichenfolge mit dem angegebenen Muster übereinstimmt. Im Gegensatz zur FsRtlIsNameInExpression-Routine-erwartet FsRtlIsNameInUnUpcasedExpression nicht, dass der Ausdruck großgeschrieben ist, wenn IgnoreCase- TRUE ist.

Syntax

BOOLEAN FsRtlIsNameInUnUpcasedExpression(
  PUNICODE_STRING Expression,
  PUNICODE_STRING Name,
  BOOLEAN         IgnoreCase,
  PWCH            UpcaseTable
);

Parameter

Expression

Ein Zeiger auf die Musterzeichenfolge. Kann Wildcardzeichen enthalten. Wenn IgnoreCase WAHR ist, muss der Ausdruck Kleinbuchstaben sein.

Name

Ein Zeiger auf die Zeichenfolge, die mit dem Muster verglichen werden soll. Darf keine Wildcardzeichen enthalten.

IgnoreCase

Legen Sie TRUE- für den Abgleich zwischen Groß- und Kleinschreibung fest, andernfalls FALSE.

UpcaseTable

Optionaler Zeiger auf großgeschriebene Zeichentabelle, die für den Abgleich zwischen Groß- und Kleinschreibung verwendet werden soll. Wenn dieser Wert nicht angegeben wird, wird die Standardtabelle für Großbuchstaben des Systems verwendet.

Rückgabewert

Gibt TRUE zurück, wenn die Zeichenfolge dem Muster entspricht, andernfalls FALSE.

Bemerkungen

Die folgenden Wildcardzeichen können in der Musterzeichenfolge verwendet werden:

Platzhalterzeichen Bedeutung
* (Sternchen) Entspricht null oder mehr Zeichen.
? (Fragezeichen) Entspricht einem einzelnen Zeichen.
DOS_DOT Entspricht entweder einem Punkt oder null Zeichen, die über die Namenszeichenfolge hinausgehen.
DOS_QM Gleicht ein einzelnes Zeichen ab oder wechselt beim Auftreten eines Punkts oder Endes der Namenszeichenfolge zum Ende des Satzes zusammenhängender DOS_QMs.
DOS_STAR Gleicht null oder mehr Zeichen ab, bis der letzte Punkt im Namen gefunden und abgleicht.

Wenn nur einer der Zeichenfolgenparameter eine Länge von Null hat, gibt FsRtlIsNameInUnUpcasedExpression FALSE zurück. Dies bedeutet, dass "*" nicht mit einer NULL-Zeichenfolge übereinstimmt. Wenn beide Parameter NULL-Zeichenfolgen sind, gibt FsRtlIsNameInUnUpcasedExpression TRUE zurück.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 10 (Version 1803)
Zielplattform- Universal
Header- ntifs.h
Library NtosKrnl.exe
IRQL- PASSIVE_LEVEL

Siehe auch