RtlCompareUnicodeString function (wdm.h)

The RtlCompareUnicodeString routine compares two Unicode strings.

Syntax

NTSYSAPI LONG RtlCompareUnicodeString(
  [in] PCUNICODE_STRING String1,
  [in] PCUNICODE_STRING String2,
  [in] BOOLEAN          CaseInSensitive
);

Parameters

[in] String1

Pointer to the first string.

[in] String2

Pointer to the second string.

[in] CaseInSensitive

If TRUE, case should be ignored when doing the comparison.

Return value

RtlCompareUnicodeString returns a signed value that gives the results of the comparison:

Return code Description
Zero
String1 equals String2.
< Zero
String1 is less than String2.
> Zero
String1 is greater than String2.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

See also

RtlCompareString

RtlEqualString