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) |