Please enable JavaScript to view this site.

ESL Documentation

Subroutine

Make a one-time data request.

 

call DDERequest ( 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 specifying the item name, which should have some meaning to the server. It must not be more than 80 characters.

Format_SV is a string value representing one of the formats listed below (defined in ESLDDE.INC), or any format string that references a text-based format that has been registered through a call to DDERegisterFormat.  Normally, DDEFMT_TEXT is used for plain text. Formats defined in ESLDDE.INC are:

DDEFMT_TEXT

DDEFMT_DIF 

DDEFMT_OEMTEXT 

DDEFMT_SYLK

Status_IV must be 0.

Description

Called by the client.  This subroutine makes a one-time data request.  Upon receipt of a one-time data request, the DDE protocol requires that the server respond as follows.  The client should not attempt another DDE exchange until the server has responded with one of these events.

Acknowledgment

Subroutine Called

Message

Positive

(Request can be honored)

DDEAck with

DDE_FACK status flag set

WM_DDE_ACK with

DDE_FACK status bit set

Negative

(Request cannot be honored)

DDEAck with

DDE_FACK status flag not set

WM_DDE_ACK with

DDE_FACK status bit cleared

Message

Posts a WM_DDE_REQUEST message to the server partner.

Example

response to RequestKey

# Get ConvID_IV

   if (not (ConvID_IV = 0)) then  # make sure a conversation

                                  # is active

      copy "itemname" to ItemName_SV

      copy DDEFMT_TEXT to Format_SV

      copy 0 to Status_IV

      call DDERequest (ConvID_IV, ItemName_SV, Format_SV, Status_IV)

   end if