Please enable JavaScript to view this site.

ESL Documentation

Subroutine

Request that an advise state be terminated.

 

call DDEUnAdvise ( 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 string value representing the item name. If this string is zero-length, the server will terminate all advise states associated with this conversation ID.

Format_SV is a string value which must be the same format that was used in the call to DDEAdvise for this data item.

Status_IV must be 0.

Description

Called by the client.  This subroutine requests that an advise state be terminated.

 

Upon receipt of a request that an advise state be terminated, 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

(Advise state has been set)

DDEAck with

DDE_FACK status flag set

WM_DDE_ACK with

DDE_FACK status bit set

Negative

(Advise state has not been set)

DDEAck with

DDE_FACK status flag not set

WM_DDE_ACK with

DDE_FACK status bit cleared

Message

Posts a WM_DDE_UNADVISE message to the server partner.

Example

response to NewTopic

    # Get ConvID

   copy "itemname" to ItemName_SV

   copy DDEFMT_TEXT to Format_SV

   copy 0 to Status_IV

   call DDEUnAdvise (ConvID_IV, ItemName_SV, Format_SV, Status_IV)