BOOL DdeAbandonTransaction(idInst, hConv, idTransaction) | |||||
DWORD idInst; | /* instance identifier | */ | |||
HCONV hConv; | /* handle of conversation | */ | |||
DWORD idTransaction; | /* transaction identifier | */ |
The DdeAbandonTransaction function abandons the specified asynchronous transaction and releases all resources associated with the transaction.
idInst
Specifies the application-instance identifier obtained by a previous call to the DdeInitialize function.
hConv
Identifies the conversation in which the transaction was initiated. If this parameter is NULL, all transactions are abandoned (the idTransaction parameter is ignored).
idTransaction
Identifies the transaction to terminate. If this parameter is NULL, all active transactions in the specified conversation are abandoned.
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
Only a dynamic data exchange (DDE) client application should call the DdeAbandonTransaction function. If the server application responds to the transaction after the client has called DdeAbandonTransaction, the system discards the transaction results. This function has no effect on synchronous transactions.
DdeClientTransaction, DdeGetLastError, DdeInitialize, DdeQueryConvInfo