DdeCmpStringHandles function (ddeml.h)

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

See also

Conceptual

DdeAccessData

DdeCreateStringHandle

DdeFreeStringHandle

Dynamic Data Exchange Management Library

Reference