Please enable JavaScript to view this site.

ESL Documentation

Invoked in:

Server

Message from Partner:

WM_DDE_POKE

Remarks:

This event is invoked in a server when a partner has sent unsolicited data.  

The application can retrieve the item name (DDEGetItemName) to determine if it is interested in the data.

DDEGetStringData can be called to retrieve the data.

Required Response:

Upon receipt of unsolicited data, the DDE protocol requires that the server respond as follows.  The server must respond to this event before attempting to transmit another event to the partner.

Acknowledgment

Acknowledgment

Subroutine Called

Message

Positive

(Data is accepted)

DDEAck with

DDE_FACK status flag set

WM_DDE_ACK with

DDE_FACK status bit set

Negative

(Data is not accepted)

DDEAck with

DDE_FACK status flag not set

WM_DDE_ACK with

DDE_FACK status bit cleared

Default Processing:

The DDE DLL default processing is to send a negative acknowledgment if the ESL program does not send an acknowledgment.

Available Queries:

DDEGetAppName

DDEGetTopic

DDEGetItemName

DDEGetStatus

DDEGetFormat

DDEGetErrorID

Example:

response to stimulus DDE DDE_POKE

   copy eventparam to ConvID_IV

   copy DDEGetItemName (ConvID_IV) to ItemName_SV

   copy DDEGetFormat (ConvID_IV) to Format_SV

   if (DataIsAcceptable (ItemName_SV, Format_SV) then

   copy DDESetStatusFlag (0, DDE_FACK) to Status_IV

   call DDEAck (ConvID_IV, ItemName_SV, Format_SV, Status_IV)

   copy DDEGetStringData (ConvID_IV) to StringData_SV

else

   copy 0 to Status_IV

   call DDEAck (ConvID_IV, ItemName_SV, Format_SV, Status_IV)

   end if