DdeSetUserHandle function (ddeml.h)

Associates an application-defined value with a conversation handle or a transaction identifier. This is useful for simplifying the processing of asynchronous transactions. An application can use the DdeQueryConvInfo function to retrieve this value.

Syntax

BOOL DdeSetUserHandle(
  [in] HCONV     hConv,
  [in] DWORD     id,
  [in] DWORD_PTR hUser
);

Parameters

[in] hConv

Type: HCONV

A handle to the conversation.

[in] id

Type: DWORD

The transaction identifier to associate with the value specified by the hUser parameter. An application should set this parameter to QID_SYNC to associate hUser with the conversation identified by the hConv parameter.

[in] hUser

Type: DWORD_PTR

The value to be associated with the conversation handle.

Return value

Type: BOOL

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

The DdeGetLastError function can be used to get the error code, which can be one of the following values:

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

DdeQueryConvInfo

Dynamic Data Exchange Management Library

Reference