Please enable JavaScript to view this site.

ESL Documentation

Subroutine

Request that the server execute one or more commands.

 

call DDEExecute ( ConvID_IV, Command_SV, DataLength_IV, Status_IV )

 

ConvID_IV is an integer value representing the conversation ID assigned by the DDE DLL.

Command_SV is a string value representing the command that the server executes. The DDE protocol does not define the format of these commands, although the DDE protocol definition document does suggest a format.  For more information, consult the documentation for the particular server for which the commands are intended.

DataLength_IV is a string value representing the length of the command.

Status_IV must be 0.

Description

Called by the client.  This subroutine requests that the server execute one or more commands.

 

Upon receipt of a request that the server execute one or more commands, the DDE protocol requires that the server respond as follows.  The client should not attempt another DDE exchange for this conversation until the server has responded with one of these events.

Acknowledgment

Subroutine Called

Message

Positive

(Command was executed)

DDEAck with

DDE_FACK status flag set

WM_DDE_ACK with

DDE_FACK status bit set

Negative

(Command cannot be executed)

DDEAck with

DDE_FACK status flag not set

WM_DDE_ACK with

DDE_FACK status bit cleared

Message

Posts a WM_DDE_EXECUTE message to the server partner.

Example

response to ExecuteKey

# Get ConvID_IV

   copy "commands to execute" to Command_SV

   copy (length of Command_SV) to DataLength_IV

   copy 0 to Status_IV

   call DDEExecute (ConvID_IV, Command_SV, DataLength_IV, Status_IV)