Freigeben über


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)

Weitere Informationen

RtlEqualUnicodeString

UNICODE_STRING