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

FsRtlAreNamesEqual gibt TRUE zurück, wenn die beiden Unicode-Zeichenfolgen übereinstimmen, FALSE andernfalls.

Bemerkungen

Die Tabelle, auf die UpcaseTable- verweist, ist ein Array von Unicode-Zeichen in Großbuchstaben, das vom Unicode-Zeichen in Großbuchstaben indiziert wird. Das Array muss Einträge für alle Zeichen enthalten, die in Dateinamen zulässig sind.

Der Abgleich zwischen Groß- und Kleinschreibung wird ausgeführt, indem beide Zeichenfolgen in Großbuchstaben konvertiert werden, bevor sie verglichen werden. Der Wert von UpcaseTablewird daher nur verwendet, wenn IgnoreCase-TRUEist.

Wenn ein Poolzuordnungsfehler auftritt, löst FsRtlAreNamesEqual eine STATUS_NO_MEMORY Ausnahme aus.

Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Run-Time Library (RTL)-Routinen.

Anforderungen

Siehe auch

RtlEqualUnicodeString

UNICODE_STRING