6.2.39. dde_init

initiates a DDE conversation with a host application

SYNOPSIS

INCLUDE 'iolib.h'
dde_init(Handle, Application, Topic)

SYNTAX

dde_init(Handle, Server, Topic) (i,o,o) (o,o,o)

ARGUMENTS

handle(Handle) (i) virtual handle which will be associated with the conversation
void(Handle) (o) real DDE handle returned by the host
string(Server) (i) DDE Server application
string(Topic) (i) Topic of conversation

DESCRIPTION

Starts a DDE (Dynamic Data Exchange) with the application 'Server' running under the MS-Windows host server.
The returned Handle is used to access the server application in later calls. If the application is not already running, WIO tries to start it. The predicate fails if the server cannot be accessed or rejects the conversation.

NOTE: This predicate is server dependent. It is available only under host servers supporting the

DDE protocol (WIO).

EXAMPLE

dde_init(pfe, pfe, editor),
dde_exec(pfe, ´filenew()´),
dde_terminate (pfe).

ERRORS

No runtime errors.

LAYERS

prolog-process, client-server, object

RELATED PREDICATES

dde_exec , dde_data , dde_terminate