Function

Return a string that is the text data associated with an event for a specified conversation.

 

DDEGetStringData ( ConvID_IV )

 

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

Description

Called by client or server.  This function returns a string that is the text data associated with the current event for the conversation specified by the ConvID_IV argument.

 

This function should only be called in response to the following events:

 

DDE_DATA 

DDE_EXECUTE 

DDE_POKE

 

Do not call after DDE_DATA stimulus if DDE_FRESPONSE is clear and the advise was established with DDE_FNODATA set.

DDEGetStringData must be called before calling DDE_ACK.

 

Example

response to stimulus DDE DDE_DATA

     copy eventparam to ConvID_IV

     copy DDEGetStatus(ConvID_IV) to Status_IV

     if (not (DDEQueryStatusFlag (Status_IV, DDE_FRESPONSE)))

         then

           #This data is part of an ongoing ADVISE

           #to find out if we're getting data

           copy DDEGetItemName(ConvID_IV) to ItemName_SV

           copy DDEGetFormat(ConvID_IV) to Format_SV

           call CheckAdviseData(ConvID_IV, ItemName_SV, Format_SV,

                                Result_BV)

           if (Result_BV) then

               #we are getting data with this message

               #ADVISE was not sent with DDE_FNODATA set

               copy DDEGetStringData(ConvID_IV) to StringData_SV

           end if

     else

           #This data is in response to a request

           copy DDEStringData(ConvID_IV) to StringData_SV

     end if