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

See also

Conceptual

DdeQueryConvInfo

Dynamic Data Exchange Management Library

Reference