Freigeben über


FsRtlIsNameInExpression-Funktion (ntifs.h)

Die FsRtlIsNameInExpression Routine bestimmt, ob eine Unicode-Zeichenfolge mit dem angegebenen Muster übereinstimmt.

Syntax

BOOLEAN FsRtlIsNameInExpression(
  [in]           PUNICODE_STRING Expression,
  [in]           PUNICODE_STRING Name,
  [in]           BOOLEAN         IgnoreCase,
  [in, optional] PWCH            UpcaseTable
);

Parameter

[in] Expression

Ein Zeiger auf die Musterzeichenfolge. Kann Wildcardzeichen enthalten. Wenn IgnoreCase-TRUE-ist, muss Ausdrucks- Großbuchstaben sein.

[in] Name

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

[in] IgnoreCase

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

[in, optional] 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

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

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 0 oder mehr Zeichen ab, bis das endgültige Zeichen gefunden und übereinstimmen. im Namen.

Unter niedrigen Ressourcenbedingungen kann FsRtlIsNameInExpression- eine strukturierte Ausnahme mit einem Code von STATUS_NO_MEMORY auslösen, den Aufrufer für die Verarbeitung vorbereiten sollten. Weitere Informationen finden Sie unter Strukturierte Ausnahmebehandlung.

Anmerkung

Wenn nur einer der Zeichenfolgenparameter eine Länge von Null hat, gibt FsRtlIsNameInExpressionFALSE-zurück. Dies bedeutet, dass "*" nicht mit einer NULL-Zeichenfolge übereinstimmt.

Wenn beide Parameter NULL-Zeichenfolgen sind, gibt FsRtlIsNameInExpressionTRUEzurück.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Diese Routine ist Windows 2000
Zielplattform- Universal
Header- ntifs.h (include FltKernel.h, Ntifs.h)
Library NtosKrnl.lib
DLL- NtosKrnl.exe
IRQL- PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Siehe auch

FsRtlIsDbcsInExpression

UNICODE_STRING