Lexigraphically compares two NULL terminated strings.
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. |