Cicode Programming Reference > Cicode Function Categories > Dynamic Data Exchange Functions Introduction > DDEhReadLn

DDEhReadLn

Reads a line of text from a DDE Conversion, for example, from an Excel spreadsheet. You need to first start a conversation with the DDEhInitiate function, and use the handle returned by that function to identify the conversation. This function allows you to read a large amount of data via DDE. Keep calling the function until an empty string is returned to verify that all the data has been read.

This function is a blocking function. It will block the calling Cicode task until the operation is complete.

Syntax

DDEhReadLn(Handle, sTopic)

Handle:

The integer handle that identifies the DDE conversation, returned from the DDEhInitiate function.

sTopic:

A unique topic name for the item; for example, the variable name, field name, or spreadsheet cell position.

Return Value

A line of data, or an empty string when all data has been read.

Related Functions

DDEhSetMode, DDEhWriteLn, DDEhInitiate, DDEhExecute, DDEhRequest, DDEhTerminate, DDEhGetLastError

Example

See DDEhWriteLn

See Also

DDE Functions