| #include <ddeml.h> |
| 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.
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.
The return value is nonzero if the function is successful. Otherwise, it is zero.
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