DDEAbortTrans( ) Function

See Also  

Ends an asynchronous dynamic data exchange (DDE) transaction.

Syntax

DDEAbortTrans(nTransactionNumber)

Returns

Logical

Arguments

nTransactionNumber

Specifies the transaction number returned by DDEExecute( ), DDEPoke( ), or DDERequest( ) when the transaction is sent to the server application.

Remarks

An asynchronous transaction allows Visual FoxPro program execution to continue without waiting for the server application to respond to a data request.

DDEExecute( ), DDEPoke( ), and DDERequest( ) wait for the period specified by DDESetOption( ) for a server application to respond, unless you specify a user-defined function to execute when the server application responds. Specifying a user-defined function to execute in these functions creates an asynchronous transaction.

If DDEAbortTrans( ) is called before the server has processed the request, the user-defined function won't be called for the transaction.

DDEAbortTrans( ) returns true (.T.) if the asynchronous transaction is successfully ended and returns false (.F.) if the asynchronous transaction cannot be ended. Use DDELastError( ) to determine why the transaction couldn't be ended.