RtlCompareUnicodeString function

Compares two Unicode strings.

Syntax

LONG RtlCompareUnicodeString(
  _In_ PCUNICODE_STRING String1,
  _In_ PCUNICODE_STRING String2,
  _In_ BOOLEAN          CaseInSensitive
);

Parameters

String1 [in]

Pointer to the first string.

String2 [in]

Pointer to the second string.

CaseInSensitive [in]

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

Return value

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
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Target platform
Universal
Header
Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)
Library
Ntdll.lib
DLL
Ntdll.dll

See also

RtlCompareString

RtlEqualString