XTYP_XACT_COMPLETE

3.1

#include <ddeml.h>

XTYP_XACT_COMPLETE
hszTopic = hsz1;       /* handle of topic-name string */
hszItem = hsz2;        /* handle of item-name string  */
hDataXact = hData;     /* handle of transaction data  */
dwXactID = dwData1;    /* transaction identifier      */
fwStatus = dwData2;    /* status flag                 */

A DDE client callback function receives this transaction when an asynchronous transaction, initiated by a call to the DdeClientTransaction function, has concluded.

Parameters

hszTopic

Value of hsz1. Identifies the topic name involved in the completed transaction.

hszItem

Value of hsz2. Identifies the item name involved in the completed transaction.

hDataXact

Value of hData. Identifies the data involved in the completed transaction, if applicable. If the transaction was successful but involved no data, this parameter is TRUE. If the transaction was unsuccessful, this parameter is NULL.

dwXactID

Value of dwData1. Contains the transaction identifier of the completed transaction.

fwStatus

Value of dwData2. Contains any applicable DDE_ status flags in the low-order word. This provides support for applications dependent on DDE_APPSTATUS bits. It is recommended that applications no longer use these bits—future versions of the DDEML may not support them.

Return Value

This transaction does not return a value.

Comments

An application need not free the data handle obtained during this transaction. If the application needs to process the data after the callback function returns, however, the application must copy the data associated with the data handle. An application can use the DdeGetData function to copy the data.