A script-enabled browser is required for this page to function properly.

DDE.INITIATE built-in function

This function opens a DDE conversation with a DDE server application.

Syntax

DDE.INITIATE (service, topic)

Parameter

Type

Description

service
VARCHAR2

DDE Server application's DDE service code.

topic
VARCHAR2

Topic name for the conversation.

The values of Service and Topic depend on the values supported by a particular DDE server application. Service is usually the name of the DDE server application program. For applications that operate on file-based documents, Topic is usually the document filename; in addition, the System topic is usually supported by each service.

Returns

PLS_INTEGER

Usage notes

An application can start more than one conversation at a time with multiple services and topics, provided the conversation identifiers are not interchanged.

This function returns the DDE conversation identifier that is a PLS_INTEGER. The conversation identifier that is returned must be used in all subsequent Execute, Poke, Request, and Terminate calls for that conversation.

To terminate the conversation, you should call DDE.TERMINATE.

Example


DECLARE
 ConvID PLS_INTEGER;
BEGIN
 /* Open a DDE conversation with Microsoft Excel for Windows
   on topic abc.xls. */
  ConvID := DDE.INITIATE('EXCEL', 'c:\abc.xls');
END;

See also

About the DDE built-in package

DDE built-in package

DDE built-in exceptions