DdeSetUserHandle

  BOOL DdeSetUserHandle(hConv,id, hUser)    
  HCONV hConv; /* handle of conversation */
  DWORD id; /* transaction identifier */
  DWORD hUser; /* application-defined value */

The DdeSetUserHandle function associates an application-defined 32-bit value with a conversation handle and transaction identifier. This is useful for simplifying the processing of asynchronous transactions. An application can use the DdeQueryConvInfo function to retrieve this value.

Parameters

hConv

Identifies the conversation.

id

Specifies the transaction identifier of an asynchronous transaction. An application should set this parameter to QID_SYNC if no asynchronous transaction is to be associated with the hUser parameter.

hUser

Identifies the value to associate with the conversation handle.

Return Value

The return value is nonzero if the function is successful. Otherwise, it is zero.

Errors

Use the DdeGetLastError function to retrieve the error value, which may be one of the following:

DMLERR_DLL_NOT_INITIALIZED
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
DMLERR_UNFOUND_QUEUE_ID

See Also

DdeQueryConvInfo