Please enable JavaScript to view this site.

ESL Documentation

Subroutine

Issue an acknowledgement.

 

call DDEAck ( ConvID_IV, ItemName_SV, Format_SV, Status_IV )

 

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

ItemName_SV is a non-zero-length string value representing the item name.

Format_SV is a string value representing the format of the data being acknowledged.

Status_IV is one of the following status flag values:

DDE_FACK 

DDE_FBUSY

DDE_FNOTPROCESSED

Description

Called by the client or server. DDEAck issues an acknowledgment.  This subroutine should only be called in response to the following events:

DDE_POKE

DDE_EXECUTE

DDE_ADVISE

DDE_UNADVISE

DDE_DATA event with the DDE_FACKREQ status flag set

DDE_REQUEST

Message

Posts a WM_DDE_ACK message to the conversation partner.

Example

response to stimulus DDE DDE_EXECUTE

 copy eventparam to ConvID_IV

   copy DDEGetStringData (ConvID_IV) to Command_SV

   copy "" to ItemName_SV

   copy "" to Format_SV

   if (CommandProcessor (Command_SV) = true) then

   # Send a positive ACK

   copy DDESetStatusFlag (0, DDE_FACK) to Status_IV

   call DDEAck (ConvID_IV, ItemName_SV, Format_SV, Status_IV)

else

   copy 0 to Status_IV     # Send a negative ACK

   call DDEAck (ConvID_IV, ItemName_SV, Format_SV, Status_IV)

   end if

 

response to stimulus DDE DDE_POKE

   copy eventparam to ConvID_IV

   copy DDEGetStatus(ConvID_IV) to Status_IV

   copy DDEGetFormat(ConvID_IV) to Format_SV

   copy DDEGetItemName(ConvID_IV) to ItemName_SV

   copy DDEGetStringData(ConvID_IV) to DataString_SV

   if (ProcessPokeData(ConvID_IV, ItemName_SV, Format_SV, DataString_SV)) then

      copy DDE_FACK to AckStatus_IV

      copy DDESetPrivateStatus(AckStatus_IV, PokeAckStatus_IV) to AckStatus_IV

   else

      copy 0 to AckStatus_IV

   end if

   call DDEAck(ConvID_IV, ItemName_SV, Format_SV, AckStatus_IV)