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.

Syntax


int WINAPI DdeCmpStringHandles(
  _In_  HSZ hsz1,
  _In_  HSZ hsz2
);

Parameters

hsz1 [in]

Type: HSZ

A handle to the first string.

hsz2 [in]

Type: HSZ

A handle to the second string.

Return value

Type: int

The return value can be one of the following values.

Return valueDescription
-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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ddeml.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
DdeAccessData
DdeCreateStringHandle
DdeFreeStringHandle
Conceptual
Dynamic Data Exchange Management Library

 

 

Community Additions

ADD
Show:
© 2014 Microsoft