FsRtlAreNamesEqual-Funktion (ntifs.h)
Die FsRtlAreNamesEqual-Routine bestimmt, ob zwei Unicode-Zeichenfolgen gleich sind.
Syntax
BOOLEAN FsRtlAreNamesEqual(
[in] PCUNICODE_STRING ConstantNameA,
[in] PCUNICODE_STRING ConstantNameB,
[in] BOOLEAN IgnoreCase,
[in, optional] PCWCH UpcaseTable
);
Parameter
[in] ConstantNameA
Ein Zeiger auf die erste Zeichenfolge. Darf keine Wildcardzeichen enthalten.
[in] ConstantNameB
Ein Zeiger auf die zweite Zeichenfolge. Darf keine Wildcardzeichen enthalten.
[in] IgnoreCase
Legen Sie bei Übereinstimmungen ohne Berücksichtigung der Groß-/Kleinschreibung auf TRUE fest, andernfalls FALSE .
[in, optional] UpcaseTable
Optionaler Zeiger auf eine Großbuchstabentabelle, die für den Abgleich ohne Berücksichtigung der Groß-/Kleinschreibung verwendet werden soll. Wenn dieser Wert nicht angegeben wird, wird die Standardmäßige System-Großbuchstabentabelle verwendet.
Rückgabewert
FsRtlAreNamesEqual gibt TRUE zurück, wenn die beiden Unicode-Zeichenfolgen übereinstimmen, andernfalls FALSE .
Hinweise
Die Tabelle, auf die upcaseTable verweist, ist ein Array von Unicode-Großbuchstaben, die durch das Unicode-Zeichen indiziert werden, das in Großbuchstaben konvertiert werden soll. Das Array muss Einträge für alle Zeichen enthalten, die in Dateinamen zulässig sind.
Der Abgleich zwischen Groß-/Kleinschreibung wird durchgeführt, indem beide Zeichenfolgen vor dem Vergleich in Großbuchstaben konvertiert werden. Daher wird der Wert von UpcaseTable, sofern angegeben, nur verwendet, wenn IgnoreCaseAUF TRUE festgelegt ist.
Wenn ein Poolzuordnungsfehler auftritt, löst FsRtlAreNamesEqual eine STATUS_NO_MEMORY Ausnahme aus.
Informationen zu anderen Zeichenfolgenverarbeitungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
Header | ntifs.h (include Ntifs.h) |
Bibliothek | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |