Lexigraphically compares two NULL terminated strings ignoring case.
This method is not affected by locale.
- Parameters:
-
| s1 | [in] NULL terminated string to compare to s2. |
| s2 | [in] NULL terminated string to compare to s1. |
| cchMax | [in] The maximum number of characters to compare (typically the smallest buffer size in the comparison). |
| pRetval | [out] The address of a P6INT32 in which will be placed the result of the comparison. If the result is zero then the string are equivalent. The result is one if s1 > s2, otherwise the result is -1 indicating that s1 < s2. |
- Returns:
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | s1, s2 and/or pRetval is NULL, or cchMax is zero. |
P6R::eTooBig | cchMax characters were compared and no differences were found, and the NULL terminator of either string was not reached. |