Platform SDK: Interprocess Communications |
The DdeCmpStringHandles function compares the values of two string handles. The value of a string handle is not related to the case of the associated string.
int DdeCmpStringHandles( HSZ hsz1, // handle to first string HSZ hsz2 // handle to second string );
The return value can be one of the following values:
Value | Meaning |
---|---|
–1 | The value of hsz1 is either 0 or less than the value of hsz2. |
0 | The values of hsz1 and hsz2 are equal (both can be 0). |
1 | The value of hsz2 is either 0 or less than the value of hsz1. |
An application that must do a case-sensitive comparison of two string handles should compare the string handles directly. An application should use DdeCmpStringHandles for all other comparisons to preserve the case-insensitive nature of dynamic data exchange (DDE).
DdeCmpStringHandles cannot be used to sort string handles alphabetically.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in Ddeml.h; include Windows.h.
Library: Use User32.lib.
Dynamic Data Exchange Management Library Overview, Dynamic Data Exchange Management Functions, DdeAccessData, DdeCreateStringHandle, DdeFreeStringHandle