win12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
WinCompareStrings (1.2)
Function Group                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINCOUNTRY
 
USHORT WinCompareStrings(hab, idcp, idcc, psz1, psz2, reserved)
HAB hab;            /* handle of the anchor block */
USHORT idcp;        /* code-page identifier       */
USHORT idcc;        /* country-code identifier    */
PSZ psz1;           /* address of first string    */
PSZ psz2;           /* address of second string   */
USHORT reserved;    /* must be zero               */
 
The WinCompareStrings function compares two strings by using the
collating-sequence table for the given country-code and code-page
identifiers.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hab        Identifies the anchor block.
 
idcp       Identifies the code page.
 
idcc       Identifies the country code.
 
psz1       Points to the first string.
 
psz2       Points to the second string.
 
reserved   Specifies a reserved value; must be zero.
 
Return Value
 
The return value is the comparison result. It can be one of the following
values:
 
Value      Meaning
────────────────────────────────────────────────────────────────────────────
WCS_EQ     Strings are equal.
 
WCS_LT     String 1 is less than string 2.
 
WCS_GT     String 1 is greater than string 2.
 
WCS_ERROR  Invalid country-code or code-page identifier.
 
See Also
 
DosGetCollate