lstrcmpi

Version 3.0

Syntax

int lstrcmpi(lpString1,lpString2)

This function compares the two strings identified by lpString1 and lpString2 lexicographically and returns a value indicating their relationship. The comparison is not case-sensitive. The comparison is made based on the current language selected by the user at setup or with the Control Panel. This function is not equivalent to the strcmpi C run-time library function.

All strings must be less than 64K in size.

Parameter Type/Description  

lpString1 LPSTR Points to the first null-terminated string to be compared.  
lpString2 LPSTR Points to the second null-terminated string to be compared.  

Return Value

The return value indicates whether lpString1 is less than, equal to, or greater than lpString2. This relationship is outlined in the following table:

Value Meaning  

< 0 lpString1 is less than lpString2.  
= 0 lpString1 is identical to lpString2.  
> 0 lpString1 is greater than lpString2.