Please enable JavaScript to view this site.

ESL Documentation

Invoked in:        

Server

Message from Partner:

WM_DDE_UNADVISE

Remarks:

This event is invoked in a server when a partner wants to terminate a previously established advise state.  An application should retrieve the item name (DDEGetItemName) if it is not certain to which item the DDEUnAdvise request corresponds, and respond with a positive or negative acknowledgment, depending on the result of this test.  A zero-length ItemName_SV indicates that the partner wants to terminate all advise states associated with that conversation ID.

Required Response:

Upon receipt of a request to terminate an advise state, 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

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

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

DDEGetFormat

DDEGetErrorID

DDEGetStatus

Example:

response to stimulus DDE DDE_UNADVISE

   copy true to HotLinkTerminated_BV

   copy eventparam to ConvID_IV

   copy DDEGetFormat (ConvID_IV) to Format_SV

   copy DDEGetItemName (ConvID_IV) to ItemName_SV

   copy DDESetStatusFlag (0, DDE_FACK) to Status_IV

   call DDEAck (ConvID_IV, ItemName_SV, Format_SV, Status_IV)