Cicode Programming Reference > Cicode Function Categories > Dynamic Data Exchange Functions > 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

Published June 2018