Export (0) Print
Expand All
Expand Minimize

FsRtlAreNamesEqual routine

The FsRtlAreNamesEqual routine determines whether two Unicode strings are equal.

Syntax


BOOLEAN FsRtlAreNamesEqual(
  _In_      PCUNICODE_STRING ConstantNameA,
  _In_      PCUNICODE_STRING ConstantNameB,
  _In_      BOOLEAN IgnoreCase,
  _In_opt_  PCWCH UpcaseTable
);

Parameters

ConstantNameA [in]

A pointer to first string. Cannot contain wildcard characters.

ConstantNameB [in]

A pointer to second string. Cannot contain wildcard characters.

IgnoreCase [in]

Set to TRUE for case-insensitive matching, FALSE otherwise.

UpcaseTable [in, optional]

Optional pointer to uppercase character table to use for case-insensitive matching. If this value is not supplied, the default system uppercase character table is used.

Return value

FsRtlAreNamesEqual returns TRUE if the two Unicode strings match, FALSE otherwise.

Remarks

The table pointed to by UpcaseTable is an array of uppercase Unicode characters, indexed by the Unicode character to be converted to uppercase. The array must contain entries for all characters that are legal in file names.

Case-insensitive matching is performed by converting both strings to uppercase before they are compared. Thus the value of UpcaseTable, if supplied, is used only if IgnoreCase is TRUE.

If a pool allocation failure occurs, FsRtlAreNamesEqual raises a STATUS_NO_MEMORY exception.

For information about other string-handling routines, see Strings.

Requirements

Header

Ntifs.h (include Ntifs.h)

Library

Ntoskrnl.lib

IRQL

PASSIVE_LEVEL

See also

RtlEqualUnicodeString
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft