DdeSetUserHandle
The DdeSetUserHandle
function associates an application-defined 32-bit 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.
BOOL DdeSetUserHandle(
|
HCONV hConv, |
// handle to
conversation |
|
DWORD id, |
// transaction
identifier |
|
DWORD hUser |
// handle to
application-defined value |
|
); |
|
Parameters
hConv
Identifies
the conversation.
id
Specifies 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.
hUser
Identifies
the value to associate with the conversation handle.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero.
Errors
The DdeGetLastError function can be used to get
the error code, which may be one of the following values:
DMLERR_DLL_NOT_INITIALIZED
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
DMLERR_UNFOUND_QUEUE_ID
See Also