DdeCmpStringHandles function (ddeml.h)

Article
02/22/2024

Compares the values of two string handles. The value of a string handle is not related to the case of the associated string.

Syntax

int DdeCmpStringHandles(
  [in] HSZ hsz1,
  [in] HSZ hsz2
);

Parameters

[in] hsz1

Type: HSZ

A handle to the first string.

[in] hsz2

Type: HSZ

A handle to the second string.

Return value

Type: int

The return value can be one of the following values.

Return value	Description
-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.

Remarks

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.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ddeml.h (include Windows.h)
Library	User32.lib
DLL	User32.dll