XTYP_EXECUTE
A dynamic data exchange (DDE) server callback function receives the XTYP_EXECUTE transaction when a client specifies XTYP_EXECUTE in the DdeClientTransaction function. A client uses this transaction to send a command string to the server.
Parameters
uFmt
Not used.
hconv
Identifies the conversation.
hsz1
Identifies the topic name.
hsz2
Not used.
hdata
Identifies the command string.
dwData1
Not used.
dwData2
Not used.
Return Values
A server callback function should return DDE_FACK if it processes this transaction, DDE_FBUSY if it is too busy to process this transaction, or DDE_FNOTPROCESSED if it rejects this transaction.
Remarks
This transaction is filtered if the server application specified the CBF_FAIL_EXECUTES flag in the DdeInitialize function.
An application must free the data handle obtained during this transaction. An application must, however, copy the command string associated with the data handle if the application must process the string after the callback function returns. An application can use the DdeGetData function to copy the data.
Because most client applications expect a server application to perform an XTYP_EXECUTE transaction synchonrously, a server should attempt to perform all processing of the XTYP_EXECUTE transaction either from within the DDE callback function or by returning the CBR_BLOCK return code. If the hdata parameter is a command that instructs the server to terminate, the server should do so after processing the XTYP_EXECUTE transaction.
See Also