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
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
